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Welcome to RealSystem, the most sophisticated system for 
streaming multimedia files across a network. This manual will help 
you produce your multimedia presentation, whether you simply 
want to stream a video from your home page or create a multimedia 


extravaganza with video, audio, animation, images, and text. 


Note 
The HTML version of this manual, available at 
http://service.real.com/help/library/encoders.html, 
contains multimedia examples you can view with 
RealPlayer. 


How this Manual is Organized 


This manual tells how to assemble a RealSystem presentation. Although it 
gives tips on producing great content, the more you know about producing 
audio, video, and graphics in general, the faster you'll put together a great 
streaming presentation. If you know the basics of HTML, you'll find it easy to 
pick up SMIL, the language used to assemble RealSystem presentations. 


Additional Information 
This manual does not explain how to use RealSystem 
tools like RealProducer. For specific information about 
running a tool, refer to the tool’s manual or online help. 


Chapter 1: What’s New in RealSystem? 
If youre familiar with previous versions of RealSystem, this chapter will give 
you a quick update on the many changes in this version of RealSystem. 


Chapter 2: Creating RealSystem Presentations 
If you are new to streaming media, this chapter walks you through the steps 
you take to put together a RealSystem presentation. 
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Chapter 3: Targeting Bandwidth 
This chapter explains how to target bandwidth connections, an important 
step for creating a streaming media presentation. 


Chapter 4: Producing Audio 
This chapter gives you pointers on capturing and digitizing high-quality 
audio. It then gives you the background you need to encode a RealAudio file. 


Chapter 5: Producing Video 
Read this chapter to learn how to capture high-quality video and optimize it 
for conversion to RealVideo. 


Chapter 6: Producing Animation 

Macromedia’s Flash animation paired with a RealAudio soundtrack produces 
dazzling animated presentations. This chapter tells you how to create Flash 
content for streaming with RealSystem. 


Chapter 7: Assembling a Presentation with SMIL 

After you create your multimedia clips, you write a SMIL file that pulls the 
presentation together. This chapter explains how to use SMIL to specify when 
and how each part of your presentation plays. 


Chapter 8: Extending SMIL 

RealNetworks has developed several extensions to SMIL that enhance its 
media streaming capabilities. This chapter explains these extensions, which 
work only with RealServer and RealPlayer. 


Chapter 9: Playing Clips in a Web Page 
If you want to integrate your presentation seamlessly into your Web page, 
follow the instructions in this chapter. 


Chapter 10: Inserting Ads in a Presentation 
This chapter explains how to use SMIL to insert ads into your streaming 
presentation. 


Chapter 11: Delivering a Presentation 

This chapter provides step-by-step instructions for moving your presentation 
files to RealServer and linking your Web page to them. It also explains how to 
use a Web server to deliver simple presentations. 


Chapter 12: Broadcasting a Presentation 


Refer to this chapter if you plan to broadcast an audio or video event. 
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Appendix A: Quick Answers to Common Questions 
If you are new to RealSystem, this appendix answers basic production 
questions and points you to additional resources on the Internet. 


Appendix B: Quick Steps for Streaming Clips 
This appendix lists the basic steps you take to get a clip to stream from 
RealServer or a Web server. 


Appendix C: Advanced Production Techniques 
For advanced users, this appendix conveys useful production techniques that 
help you get the most out of RealSystem. 


Appendix D: SMIL Quick Reference 
Once you understand SMIL as described in Chapter 7, use Appendix D as a 
reference when writing SMIL files. 


Appendix E: File Type Reference 
This appendix provides a quick reference for common file types used in 
RealSystem streaming. 


Appendix F: SMIL Language Codes 
If you create clips in different languages, you can use these codes in the SMIL 
file to indicate language choices. 


Conventions in this Manual 
The following table explains the conventions used in this manual. 


Notational Conventions 


Convention Meaning 





variables Italicized text represents variables. Substitute values 
appropriate for your situation. 





emphasis Bolded text is used for emphasis. 





[options] Square brackets indicate optional values you may or may 
not need to use. 





choice 1|choice 2 | Vertical lines separate values you can choose between. 





Ellipses indicate nonessential information omitted from 
the example. 
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Additional RealSystem Resources 


In addition to this manual, you may need the following RealNetworks 
resources, available at http://service.real.com/help/library/index.html: 


+ RealText Authoring Guide 


This manual explains how to create streaming text. You can use RealText, 


for example, to create a stock ticker or provide video subtitles. 
+» RealPix Authoring Guide 


With RealPix you can create streaming slideshows of still images. RealPix 
Authoring Guide explains how to put a RealPix presentation together with 
special effects such as fades and zooms. 


« RealServer Administration Guide 


The basic reference for the RealServer administrator, this manual explains 
how to set up, configure, and run RealServer to stream multimedia. You 
need this manual only if you are running RealServer yourself. 


« Embedded RealPlayer Extended Functionality Guide 


This guide supplements RealSystem Production Guide. It explains how to use 
JavaScript or VBScript to control RealPlayer functions for a presentation 
embedded in a Web page. 


+ RealSystem Authoring Kit 


The Authoring Kit contains production tools, utilities, and manuals in a 
single, convenient bundle. It is available through registration at 
hetp://www.realnetworks.com/products/authkit/index.html. 


+ RealSystem Software Development Kit (SDK) 


The RealSystem SDK lets you integrate applications with RealSystem or 
create new plug-ins for RealServer or RealPlayer. Knowledge of 
programming is required to use the SDK. Register for and download the 
SDK from http://www.realnetworks.com/devzone/. 


Technical Support 
For technical support with RealSystem, please fill out the form at: 


- hetp://customerrelations.real.com/scripts/rnforms 
/contact_tech_service.asp 
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The information you provide in this form will help technical support 
personnel to give you a prompt response. For general information about 
RealNetworks' technical support, visit: 


- hetp://service.real.com/help/call.html 
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WHAT?’S NEW IN REALSYSTEM? s J 

The open, end-to-end architecture of RealSystem changes the nature 
of streaming multimedia, giving you more possibilities for creating 
Web-based multimedia than before. If you’re familiar with past 


versions of RealSystem, this chapter gives you a quick look at the 


many changes in the latest releases of RealSystem. 


What’s New in Release 7? 


Release 7 is based on RealSystem G2 technology. It has all the capabilities of 
RealSystem G2, and introduces new features for RealServer 7, RealPlayer 7, and 
RealProducer 7. The following sections describe the new Release 7 features 
that affect content authoring. 


RealPlayer 7 New Features 


The following features may affect how you produce streaming media for 
RealPlayer 7. See the RealPlayer 7 online help for information about changes 
to the RealPlayer 7 user interface. 


PNG Images Supported 

RealPlayer 7 includes support for the Portable Network Graphics (PNG) image 
format (.png file extension) in addition to JPEG and GIF formats. You can now 
use PNG images in both SMIL and RealPix presentations. 


Pop Up Multiple RealPlayer 7 Windows 
You can write hyperlinks that open content in new RealPlayer 7 windows. This 


lets you pop up a new RealPlayer window when a viewer clicks a link in a SMIL 
or RealText presentation. 


Additional Information 
See “Popping Up New RealPlayer Windows” on page 
121. 
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Cache Graphics with RealPlayer 7 

You can instruct RealPlayer 7 to cache image files downloaded through HTTP. 
This is useful for SMIL presentations that RealPlayer 7 users repeatedly view. 
On reloads or revisits, RealPlayer uses cached images instead of downloading 
the images again from the server. 


Additional Information 


See “Caching Images Files” on page 125. 


View SMIL Source Mark-Up for Streamed Presentations 

RealPlayer 7 has a View>Source command that displays the mark-up for the 
presentation’s SMIL source file in your Web browser. This helps you learn how 
other content authors have assembled their presentations. 


Additional Information 
See “Viewing SMIL Source Mark-Up” on page 195. 


RealServer 7 New Features 


See RealServer Administration Guide for full information about new features in 
RealServer 7. The following RealServer 7 features may affect how you produce 
streaming media presentations. 


Ad Streaming 

RealServer 7 has an advertising extension that lets you display banner ads in 
RealPlayer during streaming presentations. You can also stream media ads in 
formats such as RealVideo and Flash. This feature works with all major ad 
serving systems. The RealServer administrator configures most features of ad 
streaming. 


Additional Information 
For information on creating SMIL presentations that 
include ads, see Chapter 10 beginning on page 149. 


What’s New in RealSystem G2? 


RealSystem G2, introduced in 1998, is a complete streaming media platform 
based on a new software architecture. Fundamentally different from previous 
versions of RealSystem, such as RealSystem 5, it uses an open architecture that 
allows software developers to add new features to RealPlayer and RealServer by 
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developing plug-ins. It is also the first streaming media system built to use a 
standards-based streaming protocol (RTSP) and timing language (SMIL). 


New Streaming Possibilities 


Text and Still Images Now Stream 

RealText and RealPix let you stream text and create streaming slideshows that 
use special effects such as fades and zooms. In RealSystem G2, they join 
RealAudio, RealVideo, and Flash as standard RealSystem clip types. In 
addition, RealPlayer G2 and RealPlayer Plus G2 can display JPEG and GIF 
images. 


Additional Information 
See “Choosing Media to Stream” on page 15. 


Popular File Formats Stream Natively 

With RealSystem, you can now stream many popular audio and video formats. 
Stream WAV files without conversion to RealAudio, for example, AVI without 
conversion to RealVideo. Note, however, that these file formats typically do 
not stream over networks as easily and robustly as RealAudio and RealVideo. 


Additional Information 
See “Choosing Media to Stream” on page 15. 


Open Plug-In Architecture Streams New File Types 

RealSystem’s open architecture lets RealNetworks’ development partners 
create plug-ins to stream virtually any file type. Automatic download of plug- 
ins ensures that RealPlayer users can play new RealSystem streaming file types 


as soon as they are introduced. 


Additional Information 
For more on the RealNetworks developer program, visit 
hetp://www.realnetworks.com/devzone/realdevelopers/. 


Advancements in RealAudio and RealVideo 


SureStream™ Technology Encodes Single Clips for Multiple Bandwidths 

The new SureStream technology available exclusively in RealSystem G2 lets 
you encode a single RealAudio or RealVideo clip for up to six separate 
bandwidths. All Web page visitors click the same link to play the clip, but their 
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RealPlayers receive different encodings appropriate for their various 
connection speeds. 


Additional Information 
See “Using SureStream Clips for Multiple Bandwidths” 
on page 39 for an overview of SureStream. 


New RealAudio Codecs Provide Superior Sound Quality 

RealSystem G2 introduces a new family of RealAudio codecs that provides fast 
encoding, superior sound, and the ability to encode a single clip for delivery at 
different bit rates using SureStream technology. 


Additional Information 
“Choosing RealAudio Codecs” on page 49 lists the new 
codecs. 


New RealVideo Codec Provides Fast Encoding for Multiple Bandwidth Clips 
RealSystem G2 introduces a new RealVideo codec that provides faster 
encoding and lets you use SureStream technology to encode a single 
RealVideo clip for up to six different bandwidths. 


Additional Information 
See “Choosing RealVideo Codecs” on page 61 for more 
information. 


Easier Presentation Assembly 


SMIL Files Coordinate Presentations 

For presentations that include more than one clip, you create a SMIL file to 
specify how and when each clip plays. SMIL, which stands for Synchronized 
Multimedia Integration Language, is a standardized language that uses a 
simple mark-up similar to HTML to coordinate a streaming presentation. 


Additional Information 
For a look at SMIL features, see “Writing a SMIL File” 
on page 22. Refer to Chapter 7 beginning on page 79 for 
instructions on using SMIL. 


Bandwidth Negotiation through Multiply-Encoded Clips or SMIL 
RealSystem G2 introduces simpler methods for supporting multiple 
bandwidth connections. As described previously, the new SureStream 
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technology allows you to encode a single RealAudio or RealVideo clip for 
multiple connection speeds. Or you can let RealPlayer choose between 
different versions of a presentation based on bandwidth parameters in the 
SMIL file. Either way, you need just one link on your Web page, and your 
encoded clips do not need to conform to any naming conventions. 


Additional Information 
See “Supporting Multiple Bandwidth Connections” on 
page 39 for an overview. 


RealPlayer Launched Automatically 

The Ramgen feature of RealServer™ can launch RealPlayer automatically. This 
means you do not need to create a Ram file (extension .ram or .rpm) manually. 
In your Web page, you link to a SMIL file or media clip, including in the URL 
a Ramgen parameter that causes the Web browser to launch RealPlayer and 
give it the SMIL file or clip. 


Additional Information 


See “Linking your Web Page to RealServer” on page 159. 


Enhanced Protocol Support 


RTSP Protocol Now Used 

Because it still supports the PNA protocol, RealServer for RealSystemG2 is 
backwards compatible with RealSystem 3.0 through 5.0. But it introduces as 
its primary protocol the RealTime Streaming Protocol (RTSP), an open, 
standards-based protocol for multimedia streaming. Because of this, URLs 
that point to media clips on RealServer now begin with rtsp://. 


RealSystem Interoperates with RTP-Based Servers and Clients 

When communicating with RealPlayer, RealServer uses RealTime Streaming 
Protocol (RTSP) as its control protocol and RealNetworks’ proprietary RDT as 
its packet protocol. But because RealSystem G2 also supports international 
standards for streaming media, RealServer and RealPlayer interoperate with 
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RTP-based media servers and clients. The following table lists the protocols 
used with different mixes of servers and clients. 


RealSystem Protocols 

















Control Packet 
Server Client Protocol Protocol 
RealServer G2 and higher | RealPlayer G2 and higher | RTSP RDT 
RealServer G2 and higher | RTP-based client RTSP RTP 
RTP-based server RealPlayer G2 and higher | RTSP RTP 
RealServer G2 and higher | RealPlayer 3.0 to 5.0 PNA PNA 
RealServer 3.0 to 5.0 RealPlayer G2 and higher | PNA PNA 














Compatibility with Previous Releases 


RealSystem 7 and RealSystem G2 are fully compatible with presentations 
developed for RealSystem 3.0 through 5.0. You do not need to change any 
existing content. RealPlayer G2 and higher can play back clips streamed by an 
earlier version of RealServer. As well, RealServer G2 and RealServer 7 can 
stream presentations originally created for earlier versions of RealSystem. 
When you create a RealSystem presentation, you can use different techniques 
to make it compatible with earlier versions of RealPlayer. 


SureStream has a Backwards-Compatibility Option 

With RealSystem’s SureStream technology, you can encode a single RealAudio 
or RealVideo clip at multiple bandwidths for RealPlayer. When you encode the 
clip, you select a backwards-compatibility option to include an encoding for 
earlier versions of RealPlayer. This works only when streaming from 
RealServer, however, because Web servers cannot serve SureStream clips. 


Additional Information 
For more on backwards compatibility with SureStream, 
see “Encoding RealAudio with RealSystem Tools” on 
page 52 and “Encoding RealVideo with RealSystem 
Tools” on page 62. 


RealServer can Stream Alternate Clips through a Single URL 
If you cannot use a single SureStream clip, create two clips, one for RealPlayer 
for RealSystem G2, and one for earlier versions of RealPlayer. You can then use 
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RealServer’s altplay option for Ramgen to deliver either clip through a single 
URL. If not using Ramgen, you can create a Ram file that lists both files. 


Additional Information 
See “Using Ramgen” on page 160. For information on 
creating a Ram file, see “Creating a Ram File Manually” 
on page 16S. 


Older RealPlayers Receive Upgrade Notice 

To add a new RealSystem G2 feature such as RealText to an existing 
presentation, you need to update the presentation. This includes creating a 
SMIL file and changing the URL in your Web page. Older versions of 
RealPlayer will not be able to play the presentation. But when viewers with 
older versions of RealPlayer click the new link, they are asked to upgrade their 
RealPlayers. 
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CREATING REALSYSTEM PRESENTATIONS J 
RealSystem gives you the power to create compelling, complex 
multimedia presentations streamed over a network. It includes 
RealServer, the most advanced streaming media server available, 
along with RealPlayer and RealPlayer Plus, the world’s most popular 
desktop applications for playing streaming media clips. This chapter 


explains the basics of how you use RealSystem to put together 


stunning multimedia presentations. 


Tip 
To experience the many possibilities of streaming media, 
download RealPlayer from http://www.real.com, then 
visit http://realguide.real.com. 


Streaming Multimedia Clips 


A RealSystem presentation can consist of one clip, such as a single RealAudio 
clip, or multiple clips played in sequence or in parallel. RealSystem streams 
these presentations over a network. If you have ever downloaded a video or 
audio clip to your Web browser, you know that it can take several minutes to 
receive a clip that plays for a few seconds. In contrast, a clip streamed by 
RealServer begins to play back almost immediately. 


Choosing Media to Stream 


RealSystem gives you many possibilities for combining media clips into 
presentations. There are two basic types of file formats you can stream with 
RealSystem: 


- Standard or “open” formats 


Editing programs typically let you save or export files to a standard, 
“open” format. Video editing programs usually let you export files as AVI 
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or QuickTime, for example. RealSystem can stream several standard 
formats, but these formats may not be optimized for network streaming. 


- Streaming formats 


Formats such as RealAudio and RealVideo are highly compressed for 
network streaming. These formats give the best results. You can convert a 
file from a standard format to a streaming format with an encoding tool. 
Some editing programs can also export files directly to streaming formats. 


Audio 
Chapter 4 beginning on page 43 discusses the audio formats you can stream: 
+ RealAudio (.rm) 
- AIFF (.aif) 
+ AU (.au) 
+ WAV (.wav) 


Video 
Chapter 5 beginning on page 55 describes the video formats you can stream: 
- RealVideo (.rm) 
- ASF (.asf) 
- AVI (.avi) 
* QuickTime (.mov) 


+ Vivo (.viv) 


Animation 


Macromedia Flash animation paired with a RealAudio soundtrack, lets you 
stream animated presentations. See Chapter 6 beginning on page 67 for 
details. 


Images 
RealSystem presentations can include still images in these formats: 
+ GIF87, GIF89, and animated GIF (.gif) 


Both interlaced and noninterlaced GIFs will work, but noninterlaced GIFs 


are recommended. 
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Text 


+ JPEG (.jpg) 
RealPlayer can display RGB baseline JPEGs. Progressive and grayscale 
JPEGs are not supported. 


+ PNG (.png) 


You can also assemble JPEG, GIF, and PNG images in a RealPix presentation 
to create eye-catching slideshows with special effects such as dissolves and 
zooms. 


Additional Information 
Download RealPix Authoring Guide from 
http://service.real.com/help/library/encoders.html. 


RealText streams text at specific times within a presentation. You can use 
RealText to add subtitles to a video, for example, or lay out text from a live 
source to create a real-time stock ticker. 


Additional Information 
Get RealText Authoring Guide, available at 
hettp://service.real.com/help/library/encoders.html. 


Additional Streaming Formats 


RealSystem’s plug-in technology lets it stream nearly any type of clip or live 
event. Check http://www.realnetworks.com/devzone for the availability of 
plug-ins that let RealSystem stream additional video and audio formats, as 
well as exciting new types of media. 


Clip Types Played by Previous RealPlayer Releases 


Most RealPlayer users upgrade when a new version of RealPlayer becomes 
available. If you need to create presentations playable by older versions of 
RealPlayer, though, take into account RealPlayer and clip type compatibility. 
The table below indicates which RealPlayer versions, such as RealPlayer G2 or 
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RealPlayer 5.0, can play which types of clips. RealPlayer 4.0, for example, plays 
only RealAudio and RealVideo. 


RealPlayer Compatibility with RealSystem Clips 























Clip Type 7 G25 4 3 2 = °1 
RealAudio X|X/]X}|X)]X}X |X 
RealVideo X}X}X}X]}-]-] - 
Flash X}X}/X]}-]-]-]- 
RealPix X}|X)/-}-)]-])-)] - 
RealText X}|X)/-}]-)]-])-)]- 
Open formats such as WAV and AVI X}|X)/-}]-)]-])-)]- 
SMIL X/}/X}-) -}-)-] - 


























Note that this table covers general clip compatibility, not codec compatibility. 
Later versions of RealPlayer typically introduce new RealAudio and RealVideo 
codecs. Earlier versions of RealPlayer cannot play the RealAudio G2 codecs, for 
example. So when planning for backwards compatibility, make sure you 
encode RealAudio or RealVideo clips with a codec available in your targeted 
versions of RealPlayer. 


Additional Information 
See also “Compatibility with Previous Releases” on page 
12. For more on codecs, see “Choosing RealAudio 
Codecs” on page 49 and “Choosing RealVideo Codecs” 
on page 61. 


Using Editing and Production Tools 


After choosing your streaming media formats, gather content and use your 
preferred editing tools to prepare your source files. Sound editing software, 
for example, lets you optimize an audio clip’s dynamic range. With video 
editing software you can set the video’s window size. RealSystem does not 
require you to use specific editing tools. Just ensure that your editing tools can 
save files in streaming formats, or in open formats you can easily convert to 
streaming formats. 
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Use Your Favorite Editing Tools to Prepare Media Files 


Audio Video 
Editing Editing 


Station == (= 
ot 


SSS) 





RealNetworks Production Tools 


If your editing program does not export files to the streaming format you 
want, you can use an encoding tool to convert the file. RealNetworks provides 
free, basic tools, and sells enhanced tools for converting popular sound and 
video formats to RealAudio and RealVideo. In addition, plug-ins for popular 
programs such as Adobe Premiere and Microsoft PowerPoint let you save 
presentations directly as RealVideo. 


RealNetworks Production Tools Create Streaming Clips 


RealAudio 
Clip 


Audio 


Video 





RealVideo 
Clip 
Additional Information 


Check http://www.realnetworks.com/products/index.html 
for the tool that’s right for you. 


Additional Tools 


RealSystem provides virtually unlimited possibilities for streaming media. It 
does not lock you into a small set of streaming formats or a specific set of 
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tools. In addition to new types of streaming media, RealNetworks’ partners 
and other parties are continually producing new tools that help you put 
together sophisticated presentations. 


Tip 
Visit http://www.realstore.com to find out about the 
many tools available to help you create streaming media. 
Also check http://www.realnetworks.com/devzone 
frequently for information about new media types and 
tools. 


Working with Timelines and Bandwidths 


As you create streaming media clips, you need to consider how to keep the 
clips synchronized to a single presentation timeline. You also need to create 
presentations for specific bandwidths. These are two important, interrelated 
steps for producing streaming multimedia presentations. 


Synchronizing Clips to a Timeline 


Because a static Web page has no timeline, images and text download without 
a preset order. You may notice when browsing a Web page that one image may 
download partially, then another image begins to appear, then the first image 
completes, and so on. A Web page does not have an internal timeline, so 
exactly when a certain image gets to the browser doesn’t matter. What matters 
is that the entire page downloads as soon as possible. 


When you stream multimedia, though, clips have timelines and must flow 
smoothly once they’ve started to play back. Imagine how jarring it would be 
for the visual track of a video to play silently for a minute, then pause as its 
audio track catches up to it a minute later. When you stream multimedia, 
therefore, it’s important that your presentation keeps clips synchronized. 
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Clip Timelines Coordinate with an Presentation Timeline 


RealVideo Clip 





RealPix Clip 
Presentation 


Timeline 


RealText Clip RealAudio Clip 
There are three aspects of timelines you may work with: 
- Clips with Internal Timelines 


Audio, video, and animation have internal timelines. In a two-minute 
video, for instance, each frame corresponds to a specific point in a two- 
minute timeline. Each second of audio meshes with each second of the 
visual image throughout the clip’s overall timeline. Your video, audio, or 
animation editing program is your main tool for manipulating the clip’s 
timeline, which is woven into the fabric of the clip. 


Clips with Variable Timelines 


With RealPix or RealText, you define timing tags that set when each image 
or text block appears. You thereby control exactly how long each image or 
text chunk stays on the screen. When combining clips, it’s typically easier 
to produce audio, video, or animation first. Then set the RealPix and 
RealText timelines to coordinate with those clips. 


Additional Information 
Get the RealPix and RealText authoring guides from 
http://service.real.com/help/library/encoders.html. 


SMIL Timing Commands 


A SMIL file assembles your presentation and can include its own timing 
elements. Timing a presentation with SMIL can be as simple as starting 
one clip as soon as another one stops. But you can also use explicit timing 
commands to delay playback for ten seconds, for example, or start a clip 
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playing at 30 seconds into its internal timeline. SMIL’s timing commands 
are optional, but they give you an extra level of flexibility you may need 
when putting multimedia clips together. 


Additional Information 
“Writing a SMIL File” on page 22 provides an overview 
of SMIL. For specifics on SMIL timing, see “Specifying 
Timing” on page 88. 


Keeping a Bandwidth Budget 


Any presentation streamed over a network has a bandwidth budget because 
each person viewing streaming clips has a network connection with a top 
speed, such as 28.8 Kilobits per second. Even when your clips are perfectly 
synchronized, the presentation may stall if at some point it requires more 
bandwidth than the viewer has available. This happens because RealServer 
needs to transmit at a certain point in the timeline more data than can get 
through the network connection to RealPlayer. 


When you develop a streaming media presentation, you need to consider the 
bandwidth constraints your audience will have. This is crucial for creating 
presentations that start to play back quickly and flow smoothly. Web users 
don’t like to wait more than a few seconds for something to happen after they 
click a link. And if your clips stop and restart frequently, viewers are not likely 
to stay watching. Fortunately, RealSystem offers sophisticated features that let 
you create a single presentation that looks good over a slow connection and 


great over a fast one. 


Additional Information 
Chapter 3 beginning on page 31 provides the details for 
considering bandwidth in streaming presentations. 


Writing a SMIL File 


With your clips in their streaming formats, you put your presentation 
together with SMIL. Pronounced “smile,” SMIL stands for “Synchronized 
Multimedia Integration Language.” A SMIL file is not necessary to stream just 
one clip. But when you have multiple clips, SMIL’s simple mark-up language 
specifies how and when the clips play. 





22 


RealSystem G2 Production Guide CHAPTER 2: Creating RealSystem Presentations 





Advantages of Using SMIL 


Coordinate Clips 
Lay Out on Different Servers 
Presentations 





Support 
Multiple 
Languages 
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Control Timing 


Advertisements Customize Presentations 





Here are some of the many advantages of using SMIL: 
- Avoid Using Container Formats 


Because RealSystem can stream many media formats, you do not need to 
merge clips into a single streaming file. To alter your presentation, for 
example, you simply edit the SMIL file rather than merge the clips again 
into a different container file. 


Use Clips in Different Locations 


Because a SMIL file lists a separate URL for each clip, you can put together 
presentations using clips in any locations. You can use a video clip from 
one server, for example, and a text clip from another. 


Support Multiple Languages 


A SMIL file can list different language options for clips. To create a video 
with soundtracks in different languages, for example, you produce one 
video clip with no soundtrack, then create audio clips in each language. 
Your Web page needs just one link to the SMIL file. When a visitor clicks 
that link, the visitor’s RealPlayer chooses a soundtrack based on its 
language preference. 





23 


CHAPTER 2: Creating RealSystem Presentations RealSystem G2 Production Guide 





- Support Multiple Bandwidths 


A SMIL file can also list presentation choices for different bandwidths. 
RealPlayer then chooses which clips to receive based on its available 
bandwidth. You can thereby support multiple connection speeds through 
a single hypertext link, rather than separate links for modem users, ISDN 
users, T1 users, and so on. 


Note 
RealSystem’s SureStream technology also lets you 
support multiple bandwidth connections within a 
single clip. For more information, see “Supporting 
Multiple Bandwidth Connections” on page 39. 


Put Together Customized Presentations 


Because a SMIL file is a simple text file, you can generate it automatically 
for each visitor. You can therefore create different presentation parts, then 
assemble a customized SMIL file based on preferences recorded in the 
visitor’s browser. 


Time and Control the Presentation 


The SMIL file lets you easily control the presentation timeline. You can 
start an audio clip playing at 2.5 seconds into its internal timeline, for 
example, without changing the encoded clip. 


Lay Out the Presentation 


When your presentation includes multiple clips, such as a RealVideo clip 
playing simultaneously with a RealPix slideshow, you use SMIL to define 
the layout. 


Include Ads 


You can use SMIL along with RealServer’s Advertising Extension to insert 
ads into your presentation. RealServer can deliver image banner ads, as 
well as rich media ads in formats such as RealVideo and Flash. 


Additional Information 
Chapter 7 beginning on page 79 describes the SMIL file 
syntax. Chapter 10 beginning on page 149 explains ad 
insertion. 
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Hosting a Presentation on a Server 


When your presentation is complete, you move the streaming media clips and 
SMIL file to RealServer or a Web server for delivery. You can play back your 
presentation in RealPlayer or directly in your Web page. The latter option, 
which uses RealPlayer’s Netscape plug-in or ActiveX Control, requires mark- 
up tags in your Web page that specify how the presentation displays. 


Additional Information 
Beginning on page 157, Chapter 11 explains how to link 
your Web page to a RealSystem presentation hosted ona 
server. For information on embedding a presentation in 
your Web page, see Chapter 9 on page 129. 


Using RealServer or a Web Server 


RealServer is the preferred host for RealSystem presentations. Designed 
specifically to stream multimedia over networks, RealServer keeps multiple 
clips synchronized and uses many advanced features to ensure that clips 
stream smoothly under adverse network conditions. Although you can use a 
standard Web server to host some streaming presentations, you will not get 
the results you’ll experience when using RealServer. 


Tip 
If you don’t have RealServer available, check out the 
hosting services of Real Broadcast Network (RBN) at 
hettp://www.realnetworks.com/rbn/index.html. RBN 
provides full services for encoding, hosting, and 
broadcasting events to small or large audiences. 


Web Server HTTP and RealServer RTSP 


A Web server uses the HTTP protocol, as you can see in Web page URLs that 
begin with http://. The HTTP protocol downloads files without regard to 
timelines, making clips with timelines more likely to stall. Although 
RealPlayer can play back clips as they download, the HTTP protocol does not 
give RealPlayer the ability to adjust the download to compensate for changing 
network conditions. 


In contrast, URLs for media clips streamed by RealServer begin with rtsp://, 
because RealServer uses Real-Time Streaming Protocol (RTSP), which is 
designed specifically to stream clips that have timelines. RTSP lets RealPlayer 
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and RealServer exchange information about a presentation in progress and 
adjust the streaming data to keep the clips playing smoothly. 


RealServer RTSP Streaming vs. Web Server HTTP Downloading 


Streaming 
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When two clips play side-by-side, for example, RealPlayer uses RTSP to 
communicate with RealServer about each clip’s progress, indicating how 
much data it needs to keep the presentation synchronized. RealServer can 
then adjust the data flow, reducing low priority data if necessary to ensure 
that crucial data gets through. Communication like this is not possible when 
a Web server sends clips to RealPlayer. 


You don’t need to know the specifics of RTSP to create great presentations. 
You just need to ensure that RealServer is available to stream your clips. If only 
a Web server is available, you can still create multimedia presentations, but 
you won't be able to use all RealSystem features. In either case, make sure you 
have a good understanding of RealSystem production as described in this 
manual before you start creating your clips. This helps ensure that your 
presentation harmonizes with the server that hosts it. 


Additional Information 
For information on RealSystem features that do not 
work with Web server hosting, read “Limitations on Web 
Server Playback” on page 163. 


Launching a Presentation 


Because some browsers may not be configured to launch RealPlayer when they 
receive a SMIL file or a media clip, you need to ensure that RealPlayer launches 
when a visitor to your Web page clicks the link to your presentation. When 
RealServer hosts your presentation, you simply include a Ramgen parameter 
in the Web page URL to launch RealPlayer. 
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Additional Information 
For more on Ramgen, see “Streaming Clips from 
RealServer” on page 158. 


When a Web server hosts your presentation, you launch RealPlayer by linking 
your Web page to a Ram file instead of a SMIL file or a media clip. When the 
browser receives the Ram file, it launches RealPlayer and gives it the Ram file, 
which contains the URLs to your media clips or SMIL file. RealPlayer uses this 
information to request the presentation from the Web server. Because the 
Ram file is a small text file, this interaction takes little time. 


Additional Information 
For more on Web server playback, see “Playing Clips 
from a Web Server” on page 161. 


Working with the RealServer Administrator 


Because earlier versions of RealServer do not handle SMIL files and many of 
the RealSystem clip types, make sure you have RealServer available to host 
your presentation. When you host a presentation on RealServer, the 
RealServer administrator will give you the basic URL parameters, such as the 
server address and its RTSP and HTTP port parameters. The RealServer 
administrator can also set up many content delivery and security features, 
such as: 


+ live broadcasts 
* pay-per-view content 
* automatic ad insertion 


+ password authentication 


Additional Information 
RealServer Administration Guide, available at 
http://service.real.com/help/library/servers.html, 
explains RealServer features. 


Using RealNetworks Logos 


When you create RealSystem content, RealNetworks encourages you to add 
RealSystem logos to your Web page. You can provide a RealPlayer download 
link button, for example, so that users can get RealPlayer from RealNetworks’ 
site and view your content. You can read RealNetworks’ trademark policy and 
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get RealSystem and RealPlayer logos from 
hetp://www.realnetworks.com/company/guide/index.html. 


Playing Clips Back Locally 


Although the main function of RealSystem is to stream media clips over a 
network, you can also create presentations that play back from a user’s local 
machine. An example is a multimedia-enhanced book written with HTML and 
containing links to RealSystem clips. Users then download all the book files 
to their local machines and play back the media clips in RealPlayer. 


In this case, you produce clips as described in this manual, except that you 
don’t have to target specific network bandwidths. When you put the 
presentation together, you simply use URLs that point to clips on the user’s 
machine instead of on RealServer or a Web server. 


Additional Information 
For more on local URLs, see “Linking to Local Clips” on 
page 84. 


Viewing a Presentation with RealPlayer 


With RealPlayer installed, you simply click the presentation link in your Web 
page to view the media clips. RealPlayer buffers the clips for a few seconds, 
then begins to play the presentation back in its own window or your browser. 
RealPlayer downloads are available from RealNetworks at 
hetp://www.real.com. 


Protecting Copyrighted Content 


Unlike a Web browser, RealPlayer does not store clips in a disk cache or allow 
users to copy or download still images. This helps you keep copyrighted 
material secure when you stream clips from RealServer. Optionally, 
RealNetworks tools let you encode video and audio clips so that viewers can 
record the streamed clips to their local machines. 


Downloading RealPlayer Plug-Ins 


RealPlayer can play virtually any streaming clip because of its plug-in 
technology. RealPlayer plug-ins function like Web browser plug-ins. When 
RealPlayer receives a streaming RealVideo clip, for example, it uses its 
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RealVideo plug-in to play the clip on your computer screen. If RealPlayer 
doesn’t have a plug-in needed to play a certain streaming clip, it downloads 
that plug-in from the Internet. 


RealPlayer Downloading a New Plug-in 
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Plug-in downloading lets you confidently develop presentations using the 
latest streaming file types available for RealSystem. If visitors to your Web 
page don’t have a plug-in needed to play your presentation, RealPlayer quickly 
downloads the plug-in and can play the presentation without having to 
restart. Because RealPlayer is the world’s most popular application for playing 
streaming media, you can be sure that your RealSystem presentation can reach 
the widest audience possible. 


Additional Information 
For information about developing RealPlayer plug-ins or 
building RealPlayer capabilities into an application, visit 
http://www.realnetworks.com/devzone/realdevelopers/. 
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TARGETING BANDWIDTH z y 
Targeting a network connection’s bandwidth is crucial for delivering 
a successful streaming media presentation. Web users with 28.8 
Kbps modems, for example, need to view presentations that require 
less than 28.8 Kilobits of data per second. As the first step in 
building your presentation, target a bandwidth and create content 


with that connection speed in mind. This helps ensure that the 


presentation streams smoothly. 


Note 
The only time you do not need to consider bandwidth is 
when all clips in your presentation reside on users’ local 
computers rather than on RealServer or a Web server. 


What is Bandwidth? 


Total bandwidth is the upper limit on how much data can pass through a 
network connection per second. Internet bandwidth is described in Kilobits 
per second (Kbps). A 28.8 Kbps modem, for example, can receive data at any 
speed up to 28.8 Kbps. Bandwidth is analogous to a speed limit, such as 60 
m.p.h. A presentation's bit rate is analogous to car speed. Based on variables 
such as weather and traffic, a car may be able to travel only 30 m.p.h. Due to 
network congestion and server load, a 28.8 Kbps modem may receive 11 Kbps 
of data one minute, 22 Kbps of data another. 


When you drive on a highway, you have no control over weather and traffic 
that makes you slow down. Under good conditions, though, you can observe 
the speed limit. Likewise with your presentation, you have no control over 
server load and network congestion when someone views your presentation. 
You can, however, ensure that your presentation does not exceed the user's 
bandwidth. On the highway, breaking the speed limit gets you a ticket. On the 
Internet, exceeding bandwidth stalls your presentation. 
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For example, a 28.8 Kbps connection can still play a presentation that requires 
a 56 Kbps stream. But the modem takes around two seconds to receive the 
data that RealPlayer has to play every second. In other words, data has to be 
displayed faster than it comes in over the modem. Consequently, RealPlayer 
does not begin playback until it receives and stores (“buffers”) enough data to 
play the presentation without halting. For a long presentation, this may take a 
few minutes. Viewers are not likely to wait that long. 


Presentation Data Must Fit RealPlayer’s Bandwidth 
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28.8 Kbps Modem Presentation 


Designing content suitable for viewers' available bandwidths is crucial to 
delivering compelling multimedia presentations. Because most Internet users 
have 28.8 Kbps modems, content available to the public should target that 
bandwidth. If your presentation is for high-speed intranet use only, you may 
be able to target a higher minimum bandwidth. Additionally, you can target 
multiple bandwidths with a single clip that looks good at low bandwidths and 
great at high bandwidths. 


What is Preroll? 


Preroll is the initial data that RealServer sends to RealPlayer before playback 
begins. Before it delivers a presentation, RealServer looks at the clip sizes and 
the timeline. Weighing these against the connection bandwidth, RealServer 
determines how much data RealPlayer must receive before starting to play the 
presentation. The preroll helps ensure that once RealPlayer commences 
playback, it does not need to halt the presentation while it receives more data. 
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As a general rule, you want preroll to be under 15 seconds, ideally under 10 


seconds. If your presentation requires more bandwidth than the user’s 


connection can supply, the presentation can still play back, but it requires a 
lengthy preroll and users are not likely to watch long while nothing happens 
on screen. Sticking to your bandwidth target helps keep presentation preroll 


to an acceptable level. 


Choosing a Target Bandwidth 


The target bandwidth of a RealSystem presentation is the maximum 
bandwidth available for a network connection, such as a 28.8 Kbps modem. 
The presentation's total bit rate must be at or below the target bit rate. The 


total bit rate comprises two main parts: 


+ Maximum bit rate consumed by all streaming clips. For a multiclip 
presentation, this can vary over time. You therefore want to consider what 


part of your presentation consumes the most bandwidth and use that 


peak point as your guideline. 


+ 25% of target bit rate for overhead (noise, data loss, and packet overhead). 
This is an approximation. Overhead can vary depending on the type of 
connection and general network conditions. A 56 Kbps analog modem 


typically requires more overhead than a digital connection running at 56 


Kbps, for example. 


If your target bit rate is 28.8 Kbps, for example, take 75% of that rate as the 
bandwidth available for your streaming clips. For a 28.8 Kbps connection, you 
have approximately 20 Kbps total for your presentation. The following table 


lists the recommended maximum bit rates for streaming presentations over 


various network connections. 


Bit Rates Available for Streaming Clips 


Target Connection Speed 


Recommended Maximum Bit 
Rate for Streaming Clips 

















14.4 Kbps modem 10 Kbps 
28.8 Kbps modem 20 Kbps 
56.0 Kbps modem 34 Kbps 
64.0 Kbps ISDN 45 Kbps 
112 Kbps dual ISDN 80 Kbps 





(Table Page 1 of 2) 
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Bit Rates Available for Streaming Clips (continued) 


Recommended Maximum Bit 





Target Connection Speed Rate for Streaming Clips 
DSL/cable modem 220 Kbps 
Corporate LAN 150 Kbps 


(Table Page 2 of 2) 


Developing a Bandwidth Strategy 


Once you know the bit rate or rates available for your streaming clips, you can 
begin to develop your bandwidth strategy. If you want to stream just one clip, 
your strategy is straightforward. Things become more complex, though, when 
you combine different clips into one presentation. But with some practice, you 
will quickly learn how to balance bandwidth requirements with presentation 
quality. 


Understanding Clip Bandwidth Characteristics 


The first step in planning your multimedia presentation is to understand the 
bandwidth characteristics of your clip or clips. The following sections describe 
characteristics for standard RealSystem media types. If you stream other types 
of clips, make sure you understand each clip’s bandwidth characteristics. 


RealAudio 


RealAudio clips consume bandwidth at a flat rate determined by the codec 
used to encode the clip. If you have a RealAudio clip encoded with an 8 Kbps 
codec, for example, that clip will steadily consume 8 Kbps of bandwidth as 
long as it plays. And with SureStream technology described in “Using 
SureStream Clips for Multiple Bandwidths” on page 39, you can encode a 
single RealAudio clip for up to six bandwidths. 


Additional Information 


See “Choosing RealAudio Codecs” on page 49. 


RealVideo 


RealVideo consumes bandwidth at a flat rate for a given bandwidth target. If 
you target 20 Kbps and use an 8 Kbps RealAudio codec for the soundtrack, the 
image track steadily consumes 12 Kbps. RealVideo encoders vary a clip’s frame 
rate and image quality to produce the best possible quality for the bandwidth 
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target. SureStream technology described in “Using SureStream Clips for 
Multiple Bandwidths” on page 39 lets you encode a single RealVideo clip for 
up to six bandwidths. 


Additional Information 
See “Choosing RealVideo Codecs” on page 61. For tips 
on shooting video, see “Recording Video” on page 57. 


Flash 


Shockwave Flash has a spiky bandwidth characteristic, meaning it consumes a 
lot of bandwidth at certain points in its timeline, little bandwidth at other 
points. RealNetworks provides tools that help you optimize Shockwave Flash 
for a specific bandwidth. 


Additional Information 
If you plan to create streaming animation, read 
“Preparing a Flash Clip” on page 67. 


RealText 


RealText consists of a text file that contains the RealText mark-up. Because it 
uses just a simple text file, RealText consumes little bandwidth. This makes it 
easy to add RealText to any presentation. 


Additional Information 
For more on RealText, get RealText Authoring Guide from 
hetp://service.real.com/help/library/encoders.html. 


RealPix 


RealPix consists of still images streamed to RealPlayer. Its bandwidth 
consumption depends on the number and size of the images, as well as how 
quickly you stream them. RealPix therefore gives you a lot of control over 
bandwidth usage through your choice of images and how you construct the 
RealPix timeline. 


Additional Information 
For more on RealPix and its bandwidth characteristics, 
refer to RealPix Authoring Guide, which is available at 
hettp://service.real.com/help/library/encoders.html. 
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Images 


By default, JPEG, GIF, and PNG images rendered directly in RealPlayer (that is, 
images that are not part of a RealPix presentation) stream at 12 Kbps. You can 
modify this bit rate through a SMIL file. 


Additional Information 
See “Defining Image Options” on page 117 for more on 
using SMIL to change image clip bandwidth use. 


Delivering a Single Media Clip 


Suppose you want to create an audio clip that Web users with 14.4 Kbps 
modems can play. You can simply create a RealAudio clip that consumes 8 
Kbps of bandwidth. Anyone with a 14.4 Kbps or higher connection can then 
listen to your presentation. However, when a clip has multiple streams, such as 
a video that contains a visual track and an audio track, you need to consider 
how much bandwidth goes to each stream. 


Suppose you want to stream a RealVideo clip at 28.8 Kbps. How much 
bandwidth should you give to the visual track and how much to the audio 
track? The answer depends on the content. Because music has a greater 
frequency range than voice, a music video requires more audio data than a 
“talking heads” interview. Hence a soundtrack with music consumes more 
bandwidth than one that uses just speech. 


The more you increase the audio track’s bandwidth, however, the more you 
have to decrease the visual track’s bandwidth. If you start with a huge video 
source file, your RealVideo encoding tool may discard a lot of the source data 
to make the encoded RealVideo data fit a certain bandwidth. Although the 
RealVideo clip will be playable, you may not like the results. Motion might 
appear too jerky, for example, or fast-moving images might not resolve 
visually. 
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Possible Audio and Video Tracks in a 20 Kbps RealVideo Clip 


28.8 Kbps 
8.8 K 





5 K Audio 
11 K Audio 


9 K Video 





The point here is that even when you stream just a single clip, your bandwidth 
target affects how you create content. If you know you'll have only a small 
bandwidth for video, for example, you can optimize the visual content to 
display in a small window at a slow frame rate. You may need to jettison 
panoramic and fast action shots that won’t fare well under these constraints. 


Additional Information 


See “Recording Video” on page 57. 


Developing Multiclip Presentations 


An exciting aspect of RealSystem is that you can develop multimedia 
presentations, such as slideshows with audio voice-overs, or video with 
scrolling subtitles. When multiple clips play together, you need to consider 
how much presentation bandwidth to allot each clip. While it’s exciting to 
create presentations that include video, slideshows, audio, and scrolling text 
all at once, viewing such presentations over slow modems may be difficult. 


The following figure illustrates a poor presentation for a low-bandwidth 
connection. The multiclip presentation starts with RealVideo and RealPix 
clips that require more than the target bandwidth at first. Bandwidth use, 
illustrated by the solid line, peaks again when the second RealVideo clip 
begins to play concurrently with the first video clip. To even out the 
bandwidth spikes, RealSystem streams a high preroll for the RealPix and 
RealVideo clips, making the presentation slow to start and likely to stall 
during transitions between clips. 
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Poor Bandwidth Use in a Multiclip Presentation 


RealText 


UTE EE Timeline 


RealVideo 


Bandwidth 


The next figure shows better bandwidth management. The presentation starts 
with a low-bandwidth RealText clip that does not interfere with streaming the 
images in the RealPix clip. A RealVideo clip starts after the RealPix clip has 
streamed all its images and does not need bandwidth. The second RealVideo 
clip starts after the first RealVideo clip has ended, so the two video clips do 
not compete for bandwidth. 


Improved Bandwidth Use in a Multiclip Presentation 


[RealText_> >RealVideo > 
HUE EE Timeline 
[____RealPix > RealVideo > 


Target 
~ \ J Bandwidth 
Tips for Creating Multiclip Presentations 


When developing a streaming multimedia presentation, keep the following 
tips in mind: 


+ Consider the presentation timeline carefully to eliminate bandwidth 
bottlenecks. These typically occur when two or more high-bandwidth 
clips play simultaneously. You may need to omit high-bandwidth pairings, 
combining high-bandwidth with low-bandwidth clips instead. 


+ Stagger the times when clips begin to play back. Every clip requires a 
certain preroll before RealPlayer can play it. Your presentation will play 
more smoothly if RealServer does not need to send more than one clip’s 
preroll at a time. 


+ Start presentations with low-bandwidth clips. Use RealText to display 
credits, for example. Or begin with a highly compressed RealAudio 
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narration before bringing in video. RealSystem can take advantage of the 
extra bandwidth to begin streaming higher bandwidth data to RealPlayer 
“behind the scenes.” 


Additional Information 
See “Smoothing Transitions between Clips” on page 
195. 


- Test presentations in “real world” circumstances, replicating your 
audience’s bandwidth conditions. Clips may play back fine when the files 
reside on your desktop computer. The presentation may bog down, 
though, when you stream the clips over a modem. 


Supporting Multiple Bandwidth Connections 


To reach a wide audience on the Internet, you need to provide content that can 
play over slow connections. You can encode a RealAudio clip at 8 Kbps, for 
example, so that anyone with a 14.4 Kbps or higher connection can play it. 
This clip will have good quality sound. But the same clip encoded as a 16 Kbps 
clip will have better sound. Encoded for 32 Kbps delivery, the clip will have 
even greater frequency response and dynamic range. 


To provide good content for users with slower connections and great content 
for those with faster connections, you can use two methods, and even mix 
them depending on your needs. With the first method, you create a single clip 
that targets different bandwidths. In the second method, you create separate 
clips for each bandwidth target and let RealPlayer choose which set of clips to 
play. Either way, you add to your Web page just one link for all visitors. You 
don’t need separate links for modems and ISDN connections, for example. 


Using SureStream Clips for Multiple Bandwidths 


With RealSystem’s SureStream technology, you can encode a RealAudio or 
RealVideo clip for up to six different bandwidths using RealSystem G2 codecs. 
For example, you can encode a single RealAudio music clip for 28.8 Kbps 
modems, 56 Kbps modems, 112 Kbps dual ISDN, and T1 connections. Your 
Web page links to this single clip, and when a visitor clicks the link, RealPlayer 
and RealServer determine which encoding to use based on the available 
bandwidth. The following figure illustrates this. 
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SureStream Clip Encoded for Multiple Bandwidths 
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RealServer and RealPlayer can even adjust this choice to compensate for 
network conditions. If a fast connection becomes bogged down because of 
high network traffic, RealServer seamlessly switches to a lower bandwidth 
encoding to prevent the presentation from stalling. When the congestion 
clears, RealServer switches back to the higher bandwidth encoding. 


Switching Bandwidths During Network Congestion 


Timeline 
HEDEDADROROROREOEE 
aa ee ay 
[G) ee==00 es 
Network Congestion 
SureStream 
Clip RealPlayer 


Additional Information 
For more on audio formats and SureStream, see 
“Choosing RealAudio Codecs” on page 49. See also 
“Choosing RealVideo Codecs” on page 61. 


Letting RealPlayer Choose between Multiple Clips 


If your presentation uses clips other than RealAudio and RealVideo, you can 
create multiple versions of the clips for different bandwidths. When you 
assemble your presentation, you use a SMIL file to designate a bandwidth 
connection for each of the different groups. When a user clicks your Web page 
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link, RealPlayer receives the SMIL file and chooses which clip group to play 
based on its own connection speed. 


The following figure illustrates a SMIL file that lists two choices between 
RealPix clips, a high-bandwidth choice and a low-bandwidth choice. 
RealPlayer chooses which clip to receive based on its connection speed and the 
SMIL file’s bandwidth parameters. Both presentations use the same 

RealAudio file, which has been encoded for multiple bandwidths. 


Bandwidth Choices through SureStream Clip and SMIL 
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High Bandwidth 


Because each connection speed uses a different set of clips, RealServer cannot 
switch between the different encodings as it can with a single SureStream clip. 
RealServer employs other techniques, however, to compensate for network 
congestion. Its advanced stream thinning capabilities let it drop low-priority 
data to decrease the presentation bandwidth temporarily. When the 
congestion clears up, it continues to stream all the presentation data. 


Additional Information 
“Setting Bandwidth Choices” on page 94 explains how 
to use a SMIL file to designate different bandwidth 
groups. See also “Switching with SureStream Clips” on 
page 199. 
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RealNetworks pioneered streaming audio with RealAudio, the first 
streaming media product for the Internet. Since its debut in 1995, 
RealAudio has become the standard for network audio, delivering 
stereo sound over 28.8 Kbps modems, and CD-quality sound at high 
connection speeds. RealSystem can stream other audio formats as 
well. This chapter explains how to prepare and encode your sound 


files for streaming. 


Steps for Streaming RealAudio 


To produce a great RealAudio clip, you need to use great source material, 
high-quality equipment, and good production practices. This section provides 
a quick overview of the steps involved in streaming a RealAudio clip. 


Creating a RealAudio Clip 





1. Capture Audio 2. Optimize Audio 
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> To create a streaming RealAudio clip, follow these basic steps: 


1. Capture audio. 


You start audio production by capturing audio from a source, such as a 
person speaking into a microphone. You might also start with a digitized 
audio source file from a compact disc, for example. 


Additional Information 
“Capturing Audio” on page 45 provides guidelines for 
capturing audio. 


. Optimize audio. 


With the audio file digitized in a common file format, such as WAV or 
AIFF, you next use a sound editor to optimize the audio for streaming. 
When broadcasting live, however, you encode the streaming audio directly 
from the source, optimizing the audio source during the capture. 


Additional Information 
See “Optimizing Audio” on page 47 for tips on sound 
editing. For more on live broadcasting, read Chapter 12 
starting on page 171. 


. Encode RealAudio clip. 


With your digitized file optimized or your live broadcast ready to go, you 
encode your source in the RealAudio format. When you do this, you 
choose a codec or set of codecs that target a network bandwidth. 


Additional Information 
“Creating RealAudio Clips” on page 48 explains 
RealAudio and its codecs. As described in “Streaming 
Other Audio Formats” on page 53, RealSystem can 
stream other audio formats as well. 


. Deliver RealAudio clip. 


With your presentation is ready to go, you make your RealAudio clip or 
broadcast available through your Website. To combine sound with 
another streaming clip, such as RealPix, you write a SMIL file. 


Additional Information 
Chapter 7 starting on page 79 explains how to create a 
SMIL file. See Chapter 11 beginning on page 157 for 
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instructions on linking your Web page to a RealAudio 
clip or a SMIL file. 


Capturing Audio 


A streaming audio clip reflects the quality of the audio source. Degradations 
in sound quality within the audio source affect the final streaming audio clip. 
The following sections will help you capture high-quality audio source files or 
broadcasts. 


Broadcasting live audio introduces several issues beyond those you need to 
consider when creating a standard clip. This is because you cannot edit a 
broadcast the way you can edit a digitized audio file. When broadcasting, 
though, you can set up your sound equipment to capture high-quality sound 
before encoding it. 


Additional Information 
For pointers on producing video, see “Recording Video” 
on page 57. 


Use High-Quality Source Media 


If you plan to stream existing material, start with the best source possible. Use 
the cleanest recording with the least amount of unwanted noise. Compact disc 
(CD) and digital audio tape (DAT) are good source media, although well- 
recorded analog sources such as records, reel-to-reel tapes, and chrome (type 
II) cassettes can sound just as good. Try to avoid “consumer grade” recording 
media such as Type I cassettes and VHS tapes. 


Choose Professional Recording Equipment 


Every piece of equipment in the audio chain—microphone, mixer, sound card, 
and so on—affects sound quality. If you intend to provide professional-quality 
audio content, invest in professional audio equipment and software. Poor- 
quality equipment can add hiss and distortion, degrading sound clarity. 


Use Shielded Cables 


It is important to use high-quality, shielded cables. Unshielded cables increase 
the chance of introducing line noise and Radio Frequency Interference (RFI) 
into recordings. Keep audio cables physically separated from power cords to 
minimize the introduction of noise. Also be sure to ground all equipment 


properly. 
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Set Input Levels Correctly 


Setting correct input levels is crucial. All audio equipment has a signal-to- 
noise ratio, the ratio between the loudest possible sound the equipment can 
reproduce without distortion and its inherent noise floor. This distortion is 
known as “clipping,” and is audible as a high-frequency crackling noise. 


To get the best signal-to-noise ratio, set the input level on each audio device in 
the signal chain so that it utilizes its full range of available amplitude without 
distortion during the program’s loudest sections. The signal chain typically 
includes a microphone, a mixing desk, a compressor, and a sound card. For 
each piece of equipment, set levels as close as possible to 0 dB without going 
over. 


Check at each point in the signal chain for signal distortion. Perform several 
test runs and make sure there are no peaks above maximum amplitude. Adjust 
levels on your sound card mixer so the input approaches but does not exceed 
the maximum. Be conservative, though. Levels might suddenly increase if, for 
instance, an interviewee suddenly speaks loudly or a crowd at a sports event 
roars. 


Prepare Volume Levels for Live Broadcasts 


When broadcasting live audio, it is useful to have a dynamics compressor (gain 
compression, not data compression), which is a piece of audio equipment that 
automatically adjusts the volume level. By providing a consistent level, the 
compressor allows you to “set and forget” the input levels to the RealAudio 
encoder. 


Use Optimum RealAudio Sampling Rates 


Try to capture sound with a sampling width of 16 bits. RealAudio codecs have 
different sampling rates that produce the best sound, however. If your sound 
card allows it, capture audio at the optimum sampling rate for the codec you 
intend to use. The RealAudio encoder will convert the file to the optimum rate 
if necessary, but this is recommended only for static files. For live broadcasts, 
use a sound card that supports the optimum rate. This avoids the overhead of 
converting the rate while encoding in real-time. 


Additional Information 
The tables beginning on page 50 list the optimum 
sampling rates for each codec. 
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Tip 
You do not need to capture stereo sound if you plan to 
use a mono codec. However, many sound cards simply 
discard the right input channel in mono mode. If you 
have a mixing desk, pan all inputs to the center so the 


conversion to mono loses nothing. 


Optimizing Audio 


If you are not broadcasting audio live, you work with a digitized audio source 
file in a supported format such as WAV, QuickTime, or AIFF. You then edit the 
audio file to optimize it.To do this, you need to be familiar with the editing 
functions your audio editing program offers. The following sections give some 
optimization tips you can carry out with your audio editing software. 


DC Offset 


DC Offset is low-frequency, inaudible noise that results from equipment 
grounding problems. If you don’t remove it, it can skew the results of 
subsequent sound editing. Use your sound editor’s DC Offset function 
immediately after recording a digital audio file. 


Tip 
If your sound editing program allows it, eliminate DC 
offset during recording. This saves you an editing step. 


Normalization 


Set sensible input levels when recording, then use normalization to maximize 
levels after recording. Your streaming files sound best when your digitized 
source has the highest possible gain without clipping. Digital audio files that 
do not utilize their full amplitude range produce low-quality streaming clips. 
If the amplitude range is too low, use your sound editor to adjust the range 
and increase the amplitude. 


Tip 
Most sound editors have a Normalize function that 
maximizes levels automatically. Because some systems 
have trouble with files normalized to 100%, normalize 
to 95% of maximum, or to -0.5dB. 
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Dynamics Compression 


Normalization maximizes the input level of the audio file’s loudest sections. 
Consequently, quiet sections may not encode as well. Dynamics compression 
evens out input levels by attenuating (turning down) the input when it rises 
above a threshold. Check your audio software for a Compression or Dynamics 
feature. You can control attenuation by specifying a compression ratio. This 
turns down the loudest sections, and you can readjust input levels accordingly. 


Tip 
For multipurpose dynamics compression, set the 
threshold to -10dB, the ratio to 4:1, and the attack and 
release times to 100ms. Adjust the input level to get 
around 3dB of compression and an output level around 
OdB. 


Equalization 


Equalization (EQ) changes the tone of the incoming signal by “boosting” 
(turning up) or “cutting” (turning down) certain frequencies. Using EQ, you 
can emphasize certain frequencies and cut frequencies that contain noise or 
unwanted sound. EQ can compensate for RealAudio codecs that do not have 
flat frequency responses (that is, codecs for which certain frequencies are not 
as loud after encoding). You can therefore use EQ to make a RealAudio clip 
sound as close as possible to the initial recording. 


Tip 
For voice-only content, you can make the file more 
intelligible by cutting frequencies below 100 Hz and 
carefully boosting frequencies in the 1-4 kHz range. 


Creating RealAudio Clips 


RealAudio is a compressed format suitable for streaming over the Internet or 
intranets. A RealAudio clip generally uses .rm as its file extension, but .ra is 
also acceptable. Because RealAudio is compressed, you typically start with a 
sound file in a digitized, uncompressed format such as WAV or AIFF. You then 
create a RealAudio clip from this source file through an encoding tool. Your 
encoding tool should be able to accept some or all of these input formats: 


- Audio Interchange Format (.aif) 


+ Audio (.au) 
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» MPEG-1 (.mpg) 

* QuickTime (.mov) 
+ Sound (.snd) 

» WAV (.wav) 


Additional Information 
RealAudio production tools are available at 
hettp://www.realnetworks.com/products/index.html. 


Choosing RealAudio Codecs 


RealAudio uses a “lossy” compression scheme that discards parts of the audio 
source file to achieve a highly reduced file size. A RealAudio clip encoded from 
a WAV source file, for example, may be 10 to 20 times smaller than the WAV 
file. Although discarding audio information during encoding lowers the clip’s 
frequency response and dynamic range, carefully choosing codecs minimizes 
the impact of compression. 


A RealAudio encoding tool uses a codec to compress the original sound file 
and create a RealAudio clip. RealPlayer uses the same codec to decompress the 
streamed RealAudio clip for playback. When you encode a RealAudio clip, you 
choose a codec (or series of codecs) based on two criteria: 


1. Bandwidth 


As Chapter 3 beginning on page 31 explains, you need to decide how 
much bandwidth each part of your presentation will consume. When you 
have a bandwidth target for your audio component, you can choose a 
codec that encodes RealAudio at or below that target. 


2. Audio Content 


RealAudio uses different codecs for music and spoken voice. Voice codecs 
focus on the standard frequency range of the human voice. Music codecs 
have broader frequency response to capture more of the high and low 
frequencies. 


The following tables provide a reference for all RealAudio codecs. Note that 
your encoding tool may not include all codecs listed. The tables give the 
following information: 
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«G2,5, 4,3; 2,1 


An “xX” in these columns indicates that a clip encoded with this codec can 
be played by RealPlayer G2 or higher, RealPlayer 5.0, RealPlayer 4.0, and so 
on. With RealSystem’s SureStream technology, you can encode a single 
clip for up to six bandwidths using the RealAudio G2 codecs. Only 
RealServer can stream SureStream clips, though, as they require a large 
download time if played back from a Web server. 


Rate 


Using a codec’s optimum sampling rate in your audio source file ensures 
that the audio stays synchronized with other media and prevents pitch 
shifting in audio resampling. Audio quality degrades if you use lower than 
the optimum sampling rate. If you use a higher sampling rate, it is best to 
use a multiple of the optimum rate. If the optimum rate is 8 kHz, for 
example, use a higher rate of 16 kHz or 32 kHz. 


Resp. 


This column lists the codec’s frequency response in kHz. A codec with a 
higher frequency response reproduces a wider range of sound than a codec 
with a lower response. A measure of codec quality, the frequency response 
does not affect how you produce audio. 


RealAudio Low Bandwidth Codecs 





























RealAudio Codec G25 4 3 2 1 Rate Resp. Comments 

5 Kbps Voice X |X |- |- |- |- |8kHz 4kHz_ | Lowest bit rate for speech or 
speech with music. 

6.5 Kbps Voice X |X |X |- |- |- |8kHz 4kHz_ | Low bit rate for speech or 
speech with music. 

6 Kbps Music-G2 Mono X |- |- |- /- |- |8kHz 3kHz_ | Use with SureStream clips. 

8 Kbps Voice X |X |X |X |X |X |8kHz 4kHz | Original voice codec. 
Superseded by 8.5Kbps Voice. 

8 Kbps Music-G2 Mono X |- |- |- /- |- |8kHz 4kHz_ | Use with SureStream clips. 

8 Kbps Music X |X |X |- |- |- |8kHz 4kHz_ | DolbyNet codec. 

8.5 Kbps Voice X |X |X |- |- |- |8kHz 4kHz_ | High-quality voice codec for 
voice or voice with music. 

11 Kbps Music-G2 Mono |X |- |- |- |- |- |11.025kHz}5kHz_ | Use with SureStream clips. 

12 Kbps Music X |X |X |- /- |- |8kHz 4kHz_ | DolbyNet codec. 
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RealAudio Medium Bandwidth Codecs 


































































































RealAudio Codec G2 5 4 3 2 1 Rate Resp. Comments 
15.2 Kbps Voice X |X |X |X |X |- |8kHz 4kHz_ | Superseded by 16 Kbps Voice. 
16 Kbps Voice-Mono X |X |- |- /- |- |16kHz 7 kHz_ | High-quality wideband for 
voice or voice with music. 

16 Kbps Music-G2 Mono |X |- |- |- |- |/- |22.05kHz |8kHz_ | Use with SureStream clips. 
16 Kbps Music-Mono Low |X |X |X |X |- |- |8kHz 4kHz_ | DolbyNet codec. 
Response 
16 Kbps Music-Mono X |X |X |X |- |- | 11.025 kHz] 4.7 kHz | DolbyNet codec for pop/rock 
Medium Response music. 
16 Kbps Music-Mono X |X |X |X |- |- | 11.025 kHz | 5.5 kHz | DolbyNet codec for classical 
High Response music. 
20 Kbps Music-G2 Mono |X |- |- |- |- |- |22.05 kHz | 10 kHz | Use with SureStream clips. 
20 Kbps Music-G2 Mono |X |- |- |- |- |- |44.1kHz | 17 kHz | High frequency response. Use 
High Response with SureStream clips. 
20 Kbps Music-G2 Stereo |X |- |- |- |- |- |11.025kHz|5kHz_ | Use with SureStream clips. 
20 Kbps Music-Stereo X |X |X |X |- |- |8kHz 4kHz_ | DolbyNet codec. 

RealAudio High Bandwidth Codecs 
RealAudio Codec G25 4 3 2 1 Rate Resp. Comments 
32 Kbps Voice-G2 Mono |X |- |- |- |- |- |22.05 kHz | 11kHz | Use with SureStream clips. 
32 Kbps Music-G2 Mono |X |- |- |- |/- |- |441kHz | 16 kHz | Use with SureStream clips. 
32 Kbps Music-G2 Mono |X |- |- |- |- |- |44.1kHz | 22 kHz | High frequency response. Use 
High Response with SureStream clips. 
32 Kbps Music-G2 Stereo |X |- |- |- |- |- |22.05kHz |8kHz | Use with SureStream clips. 
32 Kbps Music-Mono X |X |X |- |- |- |16kHz 8kHz_ | DolbyNet codec. 
32 Kbps Music-Stereo X |X |X |- |- |- | 11.025 kHz | 5.5 kHz | DolbyNet codec. 
40 Kbps Music-Mono X |X |X |X |= |- |22.05 kHz | 11 kHz | DolbyNet codec. 
40 Kbps Music-Stereo X |X |X |X |- |- |16kHz 8kHz_ | DolbyNet codec. 
44 Kbps Music-G2 Mono |X |- |- |- |- |- |44.1 kHz | 20 kHz | Use with SureStream clips. 
44 Kbps Music-G2 Stereo |X |- |- |- |- |- |22.05 kHz | 11kHz | Use with SureStream clips. 
64 Kbps Voice-G2 Mono |X |- |- |- |/- |- |44.1kHz | 20kHz | Use with SureStream clips. 
64 Kbps Music-G2 Mono |X |- |- |- |/- |- |441 kHz | 20kHz | Use with SureStream clips. 
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RealAudio High Bandwidth Codecs (continued) 














RealAudio Codec G2 5 4 3 2 1 Rate Resp. Comments 

64 Kbps Music-G2 Stereo |X |- |- |- |- |- |44.1 kHz | 16 kHz | Use with SureStream clips. 
80 Kbps Music-Mono X |X |X |X |- |- |441 kHz | 20 kHz | DolbyNet codec. 

80 Kbps Music-Stereo X |X |X |X |- |- |32kHz 16 kHz | DolbyNet codec. 

96 Kbps Music-G2 Stereo |X |- |- |- |- |- |44.1 kHz | 24kHz | Use with SureStream clips. 
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Encoding RealAudio with RealSystem Tools 


When you encode RealAudio clips with a RealSystem encoding tool, you 
simply set parameters such as audio type (voice or music) and compatibility 
with earlier versions of RealPlayer. You can also specify multiple bandwidth 
targets for the clip, such as both 28.8 Kbps modems and ISDN connections. 
The tool then chooses the best codec or codecs to use. The following sections 
give tips on using RealSystem tools. 


Additional Information 
See the tool’s manual or online help for step-by-step 
instructions on encoding RealAudio. RealSystem encoding 
tools are available for purchase or free download at 
http://www.realnetworks.com/products/index.html. 


Note 
Not all RealSystem tools may include the features 
described here. Check the product description or 
documentation for information on supported features. 


Retain Source Files 


Always keep a copy of the original audio source file. To edit the RealAudio clip 
or encode it with a different codec, modify the source file as necessary, then 
encode the file again as RealAudio. You cannot convert RealAudio clips to 
other audio formats. 


Using RealAudio in a MultiClip Presentation 


When you encode a RealAudio clip, consider whether it will play in parallel 
with another clip such as a RealPix. If you target 28.8 Kbps modems when 
encoding, for example, the tool may select a 20 Kbps codec, leaving no 
bandwidth for the second clip. Make sure you specify that the RealAudio clip 
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is just one part of the presentation. The tool then lets you choose a lower 
bandwidth codec, such as 8 or 12 Kbps. 


Multiple Encoding in a Single SureStream Clip 


You can create a single RealAudio clip encoded for up to six bandwidths with 
SureStream technology introduced in RealSystem G2. You can also specify 
backwards compatibility with earlier versions of RealPlayer. The encoding tool 
then encodes the clip for your selected bandwidths with the RealAudio G2 
codecs. It also includes in the clip an encoding that uses an older codec and 
targets the lowest bandwidth choice. 


For example, you can encode a single clip at 8, 16, and 32 Kbps using 
RealAudio G2 codecs. In the RealSystem encoding tool, you choose backwards 
compatibility to create an additional 8 Kbps stream with an older codec. 
Depending on its connection speed, RealPlayer G2 or higher receives the 8, 16, 
or 32 Kbps RealAudio G2 stream. Earlier versions of RealPlayer receive the 8 
Kbps stream encoded with the older codec regardless of their connection 


speeds. 


Note 
To support multiple bandwidths with codecs other than 
RealAudio G2 codecs, you must encode a separate clip 
with each codec. You then use SMIL to specify 
bandwidth choices. For more on bandwidth selection 
through SMIL, see “Setting Bandwidth Choices” on 
page 94. 


Batch Encoding 


Your encoding tool may have a batch mode that lets you encode several clips at 
once. The batch encoder may run through a command-line interface or a 
graphical user interface. 


Streaming Other Audio Formats 


RealSystem can stream several audio formats in addition to RealAudio. The 
following table lists the streamable formats and shows whether RealPlayer for 
different operating systems (Windows, Macintosh, and UNIX) can play the 
audio. RealSystem typically does not stream audio formats that have been 
compressed with a codec. Where codec compression is supported, codecs are 
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not included with RealPlayer and must reside on the playback machine 























already. 
Streamable Audio Formats 

Format Codeccompression Win32 Mac UNIX 
AIFF | uncompressed yes yes yes 
(.aif) 

AU uncompressed yes yes yes 
(.au) 

Way | compressed yes no no 
(.wav) | uncompressed yes yes yes 

Note 


RealSystem plug-ins may exist for additional audio formats. 
Check http://www.realnetworks.com/devzone for 
information about other audio formats you can stream. 


Tips for Streaming other Audio Formats 


Observe the following points when streaming audio formats other than 
RealAudio: 


- Test whether a codec-compressed audio clip plays in RealPlayer by copying 
the clip to each platform and opening it locally with RealPlayer. 


- A-law compression is not supported for the AU format. It is supported for 
WAV, however. 


+ Most uncompressed WAV files work on Macintosh and Unix. Some may 
not, however. Before streaming an uncompressed WAV file, test playback 
locally by opening the file with RealPlayer on these platforms. 


- The audio formats listed above may not work for low bandwidth 
connections. Test bandwidth consumption by opening the file in 
RealPlayer and watching the status panel, which will list the streaming bit 
rate. If the rate is too high, convert the file to RealAudio. 
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PRODUCING VIDEO 
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RealNetworks introduced RealVideo with RealSystem 4.0, making 
streaming video available over the Internet. This chapter covers 
RealVideo production and explains other video formats that 
RealSystem can stream. It also provides tips for capturing high- 
quality video and working with digitized video source files. 


Steps for Streaming RealVideo 


When producing a RealVideo clip, you should choose the best source material 
and best equipment possible. The goal throughout the video production 
process is to get the best video quality with the smallest streaming file size. 


Creating RealVideo Clips 


1. Record Video 2. Digitize Video 
4 i : : = 
Video 
: Editing °° ®S 
3. Encode RealVideo ‘Station = 
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Encoder 4. Deliver RealVideo 
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> The following steps summarize how to create a RealVideo clip: 


1. Capture video. 


To start video production, you capture video source by shooting a scene 
with a video camera, for example, or gathering prerecorded content from 
tape, satellite, laserdisc, or so on. 


Additional Information 
“Recording Video” on page 57 provides guidelines for 


shooting a video. 


. Digitize and edit video. 


You next digitize the video to a standard file format, such as AVI or 
QuickTime. With your preferred video editing software, you can then edit 
the video as necessary. If you are broadcasting live, however, you encode 
the streaming video directly from the source. 


Additional Information 
See “Digitizing Video” on page 58 for tips on video 
editing. For more on live broadcasting, read Chapter 12, 
starting on page 171. 


. Encode RealVideo clip. 


With your digitized file optimized or your live broadcast ready to go, you 
encode your source as RealVideo. When you do this, you target a network 
bandwidth or set of bandwidths, and choose a RealAudio codec or set of 

codecs for the audio track. 


Additional Information 
See “Creating RealVideo Clips” on page 61 for more on 
RealVideo production. “Choosing RealAudio Codecs” 
on page 49 explains RealAudio codecs. 


. Deliver RealVideo clip. 


With your presentation ready to go, you make your RealVideo clip or 
broadcast available through your Website. If you are combining video with 
another streaming clip, you write a SMIL file that assembles the pieces. 


Additional Information 
Chapter 7 starting on page 79 explains how to create a 
SMIL file. See Chapter 11 beginning on page 157 for 
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instructions on linking your Web page to a RealVideo 
clip or a SMIL file. 


Recording Video 


Observe the following points if you intend to shoot a new video rather than 
use existing video content. Because video loses image quality when 
compressed for streaming, always start with the best video source available. 


Additional Information 
For pointers on recording audio, see “Capturing Audio” 
on page 45. 


Use a High-Quality Source Format 


Whether you shoot a video yourself or digitize existing material, it’s important 
to start with a high-quality video format. The following are common 
videotape formats in order of descending quality: 


1. Betacam SP, also known simply as Beta. This format is common among 
video production professionals. 


2. DV, miniDV, DVCam, or DVCPro. 
3. Super-VHS (S-VHS) or HI-8mm. 
4. VHS, 8mm. 


Stage According to the Video’s Final Size 


It’s important to consider the video’s final frame size before you shoot the 
first frame. Reaching Web users with 28.8 Kbps modems requires a video 
window approximately 176x132 pixels. With this small size, you need to frame 
important visual elements well. 


Additional Information 
For more on window size, see “Digitizing Video” on 
page 58. 


Minimize Scene Changes and Movement 


The less that changes from frame to frame, the sharper the image will appear 
in the encoded video. RealVideo compression technology reuses existing data 
when frames are similar, so a video with relatively stationary subjects (“talking 
heads”) will look better than a music video with rapid scene changes and a lot 
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of movement. You can do the following to cut down on unnecessary 
movement: 


+ Use a mounted rather than hand-held camera. This greatly reduces the 
movement you inadvertently introduce into the scene when recording. 


+ Don’t have a rapidly moving object fill the entire frame. Keep in mind, 
though, that your streaming video may be a few square inches in size, so 
you don’t want to pull the camera back too far. 


Of course, you don’t want to eliminate all dynamic elements! When you do 
include rapid movement, give enough time for objects to resolve. Because of 
low frame rates and high compression, objects coming to rest may appear 
blurry at first. If you have a dialog box popping up on a computer screen, for 
example, show that box stationary for a few seconds so that the image resolves. 


Tip 
RealPix makes a great companion to RealVideo. When 
presenting a lecture, for example, use RealVideo to show 
the speaker and a RealPix slideshow to present visual 
aids such as information written ona blackboard. For 
more on RealPix, see “Images” on page 16. 


Use Uniform Colors and Good Lighting 


Bright lighting at a constant exposure keeps the foreground detail crisp. Use 
uniform, dark colors for backgrounds, and uniform, light colors (but not 
whites) for clothing. Complex textures such as paisley and stripes degrade the 
final image quality with unwanted visual effects. 


Digitizing Video 
If you are not broadcasting RealVideo live, you digitize the source video (direct 
camera feed, tape, disc, or so on) on your computer or video editing station. 
You can then edit the file with your preferred video editing software before 
encoding it as RealVideo. The following sections provide tips for digitizing 


video. 


Capture at 30 or 15 Frames per Second (fps) 


Capture video at 15 or, for high-bandwidth streaming, 30 fps. RealVideo 
encoding tools use a frame rate that varies with the bandwidth target and the 
emphasis on smooth motion or image quality. RealVideo’s Scalable Video 
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Technology (SVT) also allows RealVideo clips to vary in frame rate from 30 fps 
to 5 fps based on the RealPlayer computer’s processor speed. This means you 
can produce high frame rate RealVideo clips that do not overburden the 
processors of slow machines during playback. 


Use 24-bit Color Depth 


Always use 24-bit color. Lower color resolution produces poor quality videos. 


Use S-video Output 


Video playback devices commonly have at least two common output types, S- 
video and composite. Use S-video, which produces better results. 


Use a Fast Machine 


Video capture places a large burden on a computer’s CPU and hard drive. Be 
sure to have a fast machine. To avoid dropping frames during video capture, 
use a hard drive specially made for audio and video work. On Windows 
machines, you can use any video capture card that supports Video for 
Windows. 


Capture at a 320x240 Pixel Window Size 


Unless you are short on disk space or your video capture card recommends a 
different window size, capture video in a window 320 pixels wide by 240 pixels 
high. With your video editing software or RealVideo encoding tool, you can 
then reduce the window size if necessary before encoding the RealVideo clip. 


The following table, which you should use as a general guideline only, shows 
three common RealVideo clip sizes that maintain the 4:3 aspect ratio used in 
television. You can produce RealVideo at any width-to-height ratio, however. 


RealVideo Size and Bandwidth Guidelines at 10-15 fps 
Width x Height Pixel Size RealVideo Bandwidth Image Quality 








176 x 132 20-500 Kbps Good to High 
240 x 180 100-500 Kbps High 
320 x 240 200-500 Kbps High 








For each window size, the table lists bandwidth guidelines that assume a 
desired frame rate of 10 to 15 fps. The table shows that for 28.8 Kbps modems 
(20 Kbps usable bandwidth), you should use a window no larger than 
176x132. Although its overall quality will be good, the image may encode at 
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less than 10 fps. You’ll get better quality when encoding for higher 
bandwidths. 


Keep in mind that you can create a 240x180 window for bandwidths lower 
than 100 Kbps, or a 320x240 video for bandwidths lower than 200Kbps. But 
yow’re not likely to get high image resolution and 10-15 fps. The video might 
encode at 5-7 fps, for example, which may be acceptable for your audience. 
Experiment with different sizes, playing the encoded clip back in RealPlayer to 
test its quality. 


Tip 
With your RealVideo encoding tool, you can choose to 
encode a large video for low bandwidths as a “slide 
show,” which streams approximately one frame per 
second. 


Additional Information 
See Chapter 3 beginning on page 31 for details on 
targeting bandwidth. 


Digitize in AVI on Windows or QuickTime on Macintosh 


It is better to work with uncompressed formats. Otherwise, you compress the 
source once when you digitize it and again when you encode it as RealVideo. 
This double compression can decrease the image quality. Use a compressed 
source format only if your RealVideo encoding tool supports the file as input. 
You can use compressed AVI as long as the RealVideo encoding machine has 
the same Video for Windows (VFW) driver used to compress the AVI. 


Additional Information 
For more on RealVideo input formats, see “Creating 
RealVideo Clips” on page 61. 


Ensure Enough Disk Space for Digitized Video 


Use this formula to calculate the approximate size in Megabytes of a digitized 
video file: 


(pixel width) x (pixel height) x (color bit depth) x (fps) x (duration in seconds) 
8,000,000 
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Suppose you want to capture a three minute video at 15 frames per second 
with 24-bit color in a window that is 320x240 pixels. Your digitized source file 
would be approximately 622 Megabytes: 


(320) x (240) x (24) x (15) x (180) / 8,000,000 = 622 Megabytes 


If necessary, you can conserve disk space by decreasing the window size or 
lowering the frame rate. 


Tip 
Windows 95 and Macintosh operating systems limit a 
single video file to 2 Gigabytes (2048 Megabytes). Ata 
320x240 window size and 15 fps, this translates to about 
9.5 minutes of video. To work around this, create 
separate source files, encode them as separate RealVideo 
clips, and merge the clips with editing tools included 
with your RealVideo production software. 


Creating RealVideo Clips 


RealVideo’s high compression rate makes it well-suited for streaming video 
over the Internet or intranets. A RealVideo clip uses the file extension .rm and 
typically includes an embedded soundtrack encoded as RealAudio. You start 
with a video file in a digitized format, then encode a RealVideo clip from this 
source file using a RealVideo encoding tool. Your encoding tool should be able 
to accept at least one of these input formats: 


- AVI (.avi), uncompressed (recommended) or compressed 
+ MPEG-1 (.mpg) 


+ QuickTime 2.0 (.mov), uncompressed (recommended) or compressed 


Additional Information 
RealVideo production tools are available at 
hetp://www.realnetworks.com/products/index.html. 


Choosing RealVideo Codecs 


Like RealAudio, RealVideo uses a “lossy” compression scheme that discards 
parts of the source file during encoding. The following table provides a 
reference for RealVideo codecs. An “X” in the G2, 5, or 4 column indicates that 
a clip encoded with this codec can be played by RealPlayer G2 or higher, 
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RealPlayer 5.0, or RealPlayer 4.0. Earlier versions of RealPlayer do not play 
RealVideo. 














RealVideo Codecs 
RealVideo Codec G2 5 4 Comments 
RealVideo G2 with |X |- |- | All features of RealVideo G2 codec, plus Scalable 
SVT (new default) Video Technology (SVT) to scale frame rates for 
different connection speeds. 
RealVideo G2 (old |X |- |- | Use for fast encoding and encoding a single clip for 
default) multiple bandwidths using SureStream. 
Standard X |X |X | Standard codec for past releases. No multiple 
encoding in a single clip. 
Fractal X |X |X | Discontinued in RealSystem encoders. RealPlayer 
(discontinued) can play existing fractal-encoded clips, though. 

















Encoding RealVideo with RealSystem Tools 


When you encode RealVideo, you choose an overall bandwidth target or set of 
targets, then set parameters such as audio type (voice or music), compatibility 
with earlier versions of RealPlayer, and an emphasis on smooth motion or 
sharp images. After you make your choices, the encoding tool chooses the 
audio codec or codecs to use and encodes the clip using a variable frame rate. 
The following sections give tips on using RealSystem production tools. 


Additional Information 
See the tool’s manual or online help for step-by-step 
instructions on encoding RealVideo, as well as more 
information about encoding options. RealVideo production 
tools are available for purchase or free download at 
http://www.realnetworks.com/products/index.html. 


Note 
Not all RealSystem tools may include the features 
described here. Check the product description or 
documentation for information on supported features. 





62 


RealSystem G2 Production Guide CHAPTER 5: Producing Video 





Retain Source Files 


Always keep a copy of the original video source file. To edit the RealVideo clip, 
modify the source file as necessary, then encode the file again as RealVideo. 
You cannot convert RealVideo clips to other video formats. 


Using RealVideo in a MultiClip Presentation 


When you encode a RealVideo clip, consider whether it will play in parallel 
with another clip. If so, you can set an option in your encoding tool so that the 
RealVideo clip does not consume all available bandwidth. For a 28.8 Kbps 
modem connection, for example, the encoder standardly encodes the clip to 
use 20 Kbps. You can alter this default value so that the video uses 12 Kbps, 
for example, leaving bandwidth free for another clip. 


Additional Information 
Chapter 3 beginning on page 31 explains more about 
target bandwidths. 


Multiple Encoding in a Single SureStream Clip 


You can create a single RealVideo clip encoded for up to six bandwidths with 
RealSystem’s SureStream technology, which uses the RealSystem G2 video 
and audio codecs. You can also specify backwards compatibility with 
RealPlayer 5.0. The encoding tool then encodes the clip for your selected 
bandwidths with the RealVideo and RealAudio G2 codecs. It also includes in 
the clip an encoding that uses a codec compatible with RealPlayer 5.0 and 
targets the lowest bandwidth choice. 


For example, you can encode a single clip for the target connections shown in 
the table below. Based on its connection speed, RealPlayer G2 or higher 
receives the SureStream 20, 32, 45, or 80 Kbps stream. Earlier versions of 
RealPlayer receive the 20 Kbps backwards-compatible stream regardless of 
their connection speeds. Note that the RealAudio codec choices shown below 
are examples only. The encoding tool may choose other codecs depending ona 
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voice or music soundtrack, and which features of the video you want to 

















emphasize. 
RealVideo SureStream Clip Example 
RealVideo 
Target Connection Clip Bit Rate RealAudio Codec Bandwidth 
28.8 Kbps modem 20 Kbps 8 Kbps Music 12 Kbps 
(backwards compatible) 
28.8 Kbps modem 20 Kbps 8 Kbps Music-G2 Mono _ | 12 Kbps 
56.0 Kbps modem 32 Kbps 11 Kbps Music-G2 Mono | 21 Kbps 
56.0 Kbps ISDN 45 Kbps 20 Kbps Music-G2 Stereo | 25 Kbps 
112 Kbps dual ISDN 80 Kbps 44 Kbps Music-G2 Stereo | 36 Kbps 














Additional Information 
For information on RealAudio codecs, see “Choosing 
RealAudio Codecs” on page 49. 


Note 
To support multiple bandwidths without using 
SureStream and the RealSystem G2 codecs, you must 
encode a separate clip with each codec. You then use a 
SMIL file to specify bandwidth choices. For more on 
bandwidth selection through SMIL, see “Setting 
Bandwidth Choices” on page 94. 


Scaling Frame Rates with SVT 


RealVideo’s Scalable Video Technology (SVT) lets you encode a single, large 
RealVideo clip at a high frame rate, such as 30 frames per second. This gives 
viewers with fast machines and high bandwidth connections the best video 
quality possible. For viewers with slower machines, SVT automatically reduces 
the clip’s frame rate to an optimal level. For example, SVT can smoothly scale 
down a RealVideo clip encoded at 30 fps to a minimum of S fps. 


Tip 
If you do not use the RealVideo G2 SVT codec, 
RealVideo clips encoded for 200 Kbps or higher 
bandwidths may have image quality and frame rates 
that overburden processors slower than 120 Mhz. 
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Video Window Cropping 


When you encode with the new RealVideo standard codec, the encoding tool 
crops the video window to multiples of 4 pixels, so a 176x132 video stays its 
original size. With the older standard codec, the tool crops to multiples of 16 
pixels, however, so a 176x132 video encodes at 176x128 pixels. Some encoding 
tools also let you manually crop or resize the video. 


Batch Encoding 


Your encoding tool may have a batch mode that lets you encode several clips at 
once. The batch encoder may run through a command-line interface or a 
graphical user interface. 


Streaming Other Video Formats 


RealSystem can stream several video formats in addition to RealVideo. The 
following table lists the streamable formats and shows whether RealPlayer for 
different operating systems (Windows 95 or NT, Macintosh, and UNIX) can 
play back the video. RealSystem supports all Vivo codecs. For other video 
formats, however, it typically does not stream codec-compressed files. When 
codec compression other than Vivo is supported, codecs are not included with 
RealPlayer and must reside on the playback machine already. 


Streamable Video Formats 






































Format Codec compression Win32 Mac UNIX 

compressed yes no no 
ASF 1.0 (.asf) 

uncompressed yes yes yes 

compressed yes no no 
AVI 1.0 (.avi) 

uncompressed yes yes yes 
QuickTime 2.0 compressed yes no no 
(.mov) uncompressed yes yes yes 
Vivo (.viv) compressed yes yes yes 

Note 


RealSystem plug-ins may exist for other video formats. 
Check http://www.realnetworks.com/devzone for 
information about additional video formats you can 
stream. 
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Tips for Streaming other Video Formats 


Observe the following points when streaming video formats other than 
RealVideo: 


- Test whether a codec-compressed video clip plays in RealPlayer by copying 
the clip to each platform and opening it locally with RealPlayer. 


+» For the ASF and QuickTime formats, RealSystem ignores any tracks other 
than video or audio. It disregards scripting commands, for example. 


» For QuickTime 2.0 on Windows, RealPlayer supports CVID, Cinepak, and 
Indeo codec compression, provided those codecs are installed on the 
machine already. 


- Because other video formats may not be as highly compressed as 
RealVideo, they may not be good for low bandwidth connections. Test 
bandwidth needs by opening the file in RealPlayer and watching the 
RealPlayer status panel, which will list the streaming bit rate. If the rate is 
too high for your target audience, use RealVideo instead. 


- For high-bandwidth connections or videos that play back from a uset’s 
local disk, CPU power is a consideration. Play the file in RealPlayer and 
monitor CPU use with the tool of your choice. Decide whether an 
“average” machine for your target audience can handle the load. If CPU 
use is too high, convert the video to a high-bandwidth RealVideo clip. 
This creates a high-quality video with a lower CPU requirement. 
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Flash makes it easy to put animation on the World Wide Web. 





PRODUCING ANIMATION 


Combining the power of Macromedia Shockwave Flash with the 
clarity of RealNetworks’ RealAudio, Flash with RealSystem G2 
produces visually arresting animations with superb sound. This 
chapter explains how to create Flash content for different 
bandwidths. It also provides tips for optimizing Shockwave Flash 
clips. 


Additional Information 
For instructions about using Macromedia Flash, refer to 
Macromedia documentation. Find more information at 
hettp://www.macromedia.com/software/flash/. 


Preparing a Flash Clip 


Flash is well-suited for linear presentations that have continuous audio and 
images synchronized along a timeline, including: 


+ full-length, television-like cartoons for entertainment and education, 


+ Internet or intranet demonstrations, training courses, and product 
overviews, 


+ product advertisements, 
* movie trailers, 
+ and Karaoke. 


A streaming Flash clip consists of two separate files streamed in parallel: a 
Shockwave Flash animation file and a RealAudio soundtrack. To create these 
components, you develop animation in Macromedia Flash and synchronize it 
with an imported sound file, such as a WAV or AIFF file. You then export a 
Shockwave Flash file that contains the animation, and generate a RealAudio 
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file from the soundtrack. RealServer streams the clip to RealPlayer, ensuring 
that animation and sound stay synchronized. 


Streaming Flash Clips Consist of Shockwave Flash and RealAudio 





Shockwave 
Flash Clip RealServer RealPlayer 
EO. cccee a. 
6, i asaena @ & 
Presentation ar 
\ Streams 
RealAudio 
Clip 
Tip 


Macromedia Flash provides different methods for 
incorporating sound into an animation. Use the stream 
synchronization setting. 


Note 
RealPlayer supports Macromedia Flash 2.0 features. It 
does not support most features introduced in Flash 3.0, 
such as alpha channels and transparency. Morphing 
(“shape tweening”) is supported but should be used 
sparingly to keep the streaming file size low. 


Choosing a Target Bandwidth 


When you begin to develop your Flash animation, target an audience 
connection speed and create content with that bandwidth in mind. This helps 
ensure that both the Shockwave Flash animation and the RealAudio clip 
stream smoothly. If your target bit rate is 28.8 Kbps, for example, you have 
approximately 20 Kbps of bandwidth to divide between the RealAudio 
soundtrack stream and the Shockwave Flash animation stream. 


Additional Information 
For an overview of bandwidth considerations, see 
Chapter 3 beginning on page 31. 
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The good news is that designing Realflash content for a low bandwidth does 
not diminish the quality of the animation. Flash transmits vector information 


that the viewer's machine then renders. So unlike bitmap animations, Flash 


animation depends more on the machine's CPU and graphics capabilities 
than the amount of data downloaded. A well-designed 28.8 Kbps Flash 
animation can have the same visual impact as an animation requiring a 


significantly higher connection speed. 


Dividing Bandwidth Between Shockwave Flash and RealAudio 


Once you have determined the combined bit rate for Shockwave Flash and 
RealAudio, you need to divide the rate between the Shockwave Flash and 


RealAudio components. Your animation usually determines this division 


because it typically consumes more bandwidth. Although you may not have a 


final bandwidth figure until you create, export, and tune your animation, you 
should start with a target estimate. The table below lists possible RealAudio 


and Shockwave Flash bit rate combinations for a 28.8 Kbps connection (20 


Kbps usable). 


Recommended Bandwidth Divisions between RealAudio and Flash at 20Kbps 


Presentation Type 


RealAudio 


Shockwave Flash 





Emphasis on animation with good quality 
spoken soundtrack for RealPlayer G2 and 5.0 


5 Kbps Voice 


15 Kbps 


























Emphasis on animation with better quality 6.5 Kbps Voice 13.5 Kbps 
spoken soundtrack for RealPlayer G2 and 5.0 

Emphasis on animation with high quality 8.5 Kbps Voice 11.5 Kbps 
spoken soundtrack for RealPlayer G2 and 5.0 

Emphasis on animation with good quality 8 Kbps Music 12 Kbps 
music soundtrack for RealPlayer G2 and 5.0 

Emphasis on animation with good quality 6 Kbps Music- 14 Kbps 
music soundtrack for RealPlayer G2 or higher | G2 Mono 

Emphasis on animation with higher quality 8 Kbps Music- 12 Kbps 
music soundtrack for RealPlayer G2 or higher | G2 Mono 

Emphasis on high quality music soundtrack | 11 Kbps Music- | 9 Kbps 
with animation for RealPlayer G2 or higher G2 Mono 





Additional Information 


See “Choosing RealAudio Codecs” on page 49 for a full 


list of codecs. 
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Tips for Choosing RealAudio Codecs 
Here are some tips for selecting a RealAudio codec: 


+ Because RealAudio bandwidth consumption is flat, a soundtrack using an 
8.5 Kbps codec, for example, will consistently consume 8.5 Kbps of 
bandwidth. The remainder of the combined bandwidth is available for 
Shockwave Flash. 


- If sound quality takes precedence, start by selecting the RealAudio codec 
that supplies high-quality audio while leaving enough bandwidth for 


acceptable animation. 


+ When animation is complex, use low bit rate RealAudio codecs targeted 
for voice. This increases the bandwidth available for complex animation. 


- The lowest bit rate for a RealSystem G2 music codec is 6 Kbps. The lowest 
bit rate for a music codec playable by RealPlayer G2 or higher, as well as 
RealPlayer 5.0 is 8 Kbps. 


+ With SureStream technology and the RealSystem G2 codecs, you can 
encode a single RealAudio file for multiple bandwidths. RealPlayer then 
selects the bandwidth encoding appropriate to its connection speed. 


Additional Information 
For the basics of SureStream, read “Using SureStream 
Clips for Multiple Bandwidths” on page 39. 


Adding RealPlayer 5.0 Compatibility 


RealPlayer G2 (or higher) and RealPlayer 5.0 can both play Flash 
presentations, but RealPlayer 5.0 does not support all the options available 
with RealPlayer G2 and higher: 


- Flash for RealPlayer 5.0 supports only Flash 2.0 features. 


- RealPlayer 5.0 cannot read SMIL files or play a presentation that includes 
RealPix or RealText. 


- RealPlayer 5.0 cannot play soundtracks encoded with RealAudio G2 
codecs. 


To support RealPlayer 5.0 along with RealPlayer G2, avoid using Flash 3.0 
features and use any of the following methods when encoding the soundtrack 
as RealAudio: 
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1. Create a RealAudio SureStream clip that uses RealAudio G2 codecs for 
one or more bandwidths. When encoding, choose the backwards- 
compatibility option to create an encoding for RealPlayer 5.0. 


Additional Information 
For more on SureStream and RealPlayer 5.0 
compatibility, see “Multiple Encoding in a Single 
SureStream Clip” on page 53. 


2. Create two separate encodings of the soundtrack: one that uses 
RealSystem G2 codecs and one that uses a codec playable by RealPlayer 
5.0. 


3. Create one soundtrack using a RealAudio 5.0 codec. This option does not 
deliver the highest-quality sound to RealPlayer G2 users, however. 


Additional Information 
For information about creating Web page links to these 
types of presentations, see “Supporting RealPlayer 5.0” 
on page 77. 


Maximizing Flash Efficiency 


Unlike RealAudio, Shockwave Flash does not consume bandwidth at an even 
rate. This is the nature of vector-based animation. At the start ofa scene, for 
example, groups and symbols for the scene are streamed. This requires a lot of 
data transfer. After that, only “lightweight” instructions for manipulating 
groups and symbols are needed. This process results in bandwidth 
consumption like that shown in the following figure. 
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Shockwave Flash Sample Bit Rate Requirement 
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This graph shows a sample Shockwave Flash clip that targets a bandwidth of 
12 Kbps. At five and ten seconds into the clip, the bandwidth requirement 
spikes because the clip requires more than 12 Kb of data. These spikes 
typically correspond to scene changes or the introduction of new objects in a 
key frame. RealPlayer responds by buffering the data as it comes in, potentially 
delaying playback until all necessary data has arrived. 


As you create your Macromedia Flash animation, you need to minimize the 
spikes that may cause RealPlayer to halt the presentation while it buffers data. 
There are two ways you can do this: 


1. As you create your animation, minimize the overall bit rate requirement of 
the Shockwave Flash stream by keeping the ratio of file size to clip length 
as low as possible. This doesn't eliminate spikes, but it helps keep the 
spikes smaller. The guidelines below explain how to do this. 


2. After you export your animation file, use the Shockwave Flash tuning 
utility to change the streaming file's bandwidth consumption. You can 
also use the Flash Bit Rate Calculation Spreadsheet to view frame-by- 
frame bandwidth needs. 


Additional Information 
“Tuning Shockwave Flash” on page 76. 


Keeping Shockwave Flash Files Small 


The following are recommendations for keeping Shockwave Flash file size 
down as you develop the animation: 
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+ Reduce key frames. 


Excessive key frame changes increase bandwidth consumption. Minimize 
the number of key frames and simplify the objects within key frames. 


Use symbols instead of groups. 


Flash stores a symbol once and can refer to it repeatedly, each reference 
adding little to the file size. However, it stores a group definition each 
time the group is used. Using a group three times, for example, stores the 
same data in the file three times. Using symbols instead of groups can 
therefore reduce file size significantly. 


Minimize morphing. 
The Macromedia Flash 3.0 morphing feature (“shape tweening”) creates 


additional key frames and hence increases the file size and streaming bit 
rate. 


Simplify elements. 


Simplify the elements drawn in or imported into Macromedia Flash. 
Under Modify>Curves, use the Smooth and Straighten commands on lines 
and curves to strip away unneeded point and path information. This 
reduces the data stored for each element. Use Optimize to optimize the 
data reduction while maintaining acceptable screen appearance. Because 
screen resolution is lower than print resolution, you can eliminate minute 
details without compromising appearance. 


Adjust JPEG quality when exporting. 


When exporting .fla files to .swf files, set the JPEG quality to no greater 
than 50, possibly as low as 30. 


Minimizing CPU Usage 


Bandwidth is not the only consideration when optimizing files. Macromedia 
Flash's vector-based animation differs from raster or bitmap animation in 
that the user's machine must perform complex calculations to display the 
animation. Operations that require many calculations on top of the normal 
load may adversely affect playback. The following are ways to reduce Flash 
CPU requirements: 


- Set a frame rate of seven (7) fps for 28.8 Kbps connections. This provides 
acceptably smooth motion without overburdening most processors. 
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Using Interactive Commands 


+ Optimize tweening. 


Tweening interpolates the motion between key frames. Interpolating 


multiple objects and color effects at the same time will adversely affect 


playback. Other actions related to tweening that slow down playback are 


changing large areas of the screen between frames and using gradient fills. 


+ Decrease the number and size of objects simultaneously moving on 


screen. 


RealPlayer must redraw areas where action occurs, thus consuming CPU 


cycles. To minimize this, localize tweening to a small portion of the screen 


so that the entire screen does not have to be redrawn. File size remains the 


same, but only one part of the screen is redrawn. 


Although Flash is best suited for linear presentations, you can add 


interactivity through the Shockwave commands listed below. Flash maps 


these commands to RealPlayer functions. At the end of your Flash clip, for 


example, you might have a graphic that says, “Click here to visit our home 


page.” The Shockwave Get URL command used with this graphic corresponds 


to an internal RealPlayer command that displays the URL in the browser 

















window. 
Shockwave and RealPlayer Interactive Commands 

Shockwave RealPlayer 

Command Mapping Action 

Play Play Playback begins or resumes. 

Stop Pause Clip pauses until action is performed or the Play button 

is pressed. 
Goto Seek and RealPlayer seeks to the designated frame, buffers the 
Pause clip preroll, and pauses. 

Goto and Seek and RealPlayer seeks to the designated frame, buffers the 
Play Play clip preroll, and begins playback. 

Get URL (internal) | Displays URL in browser window. Because the user has 








to return to the animation manually, use this only at 


the end of a clip. 
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Tip 
Because seeking requires buffering, do not use Goto 
commands to advance from one scene to the next. When 
you export your animation to Shockwave Flash, scenes 
are concatenated so that the animation flows from one 
scene to the next. 


Additional Information 
A SMIL file can define clickable hyperlinks for the 
presentation. See “Linking to Other Media” on page 
108. 


Creating a Flash Clip 


The following sections explain the steps for creating a Flash clip once you 
finish developing your animation in Macromedia Flash. Refer to the manuals 
for the tools you use for step-by-step instructions on carrying out each task. 


Exporting Shockwave Flash 


You export your animation to a Shockwave Flash 2.0 file (.swf) for use with 
RealSystem. This creates a compressed version of the animation suitable for 
streaming. When you export the Shockwave Flash file, you disable the audio 
stream. You later export the soundtrack separately and convert it to 
RealAudio. Here are tips on exporting Shockwave Flash: 


+ Set JPEG quality between 30 and 50. This helps to keep the file size down. 


+ Click the Generate Size Report checkbox. This creates a movie report you 
can use with the tuning spreadsheet. RealNetworks recommends that you 
use the movie report and spreadsheet to evaluate your Flash clip for 
bandwidth efficiency. 


The ratio of Shockwave file size to clip length is a good indication of the 
overall bandwidth requirement. Convert the file size to Kilobits and divide by 
the number of seconds in the animation to get the average bandwidth. This 
number should be below your allowable bit rate for Shockwave Flash. For 
example, to find the average bandwidth of a 325 Kilobyte file that plays for 3 
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minutes, multiply 325 by 8 to get 2624 Kilobits. Then divide by 180 seconds to 
get an average bandwidth of 14.6 Kbps. 


Converting File Size to Kilobits 














Using This Measurement Do This to Get Kilobits 
Megabytes Multiply by 8192 
Kilobytes Multiply by 8 
bytes Divide by 128 
bits Divide by 1024 

Tip 


You can also find the average bit rate of a Shockwave 
Flash file by dropping it onto RealPlayer and observing 
the RealPlayer status bar. 


Keep in mind that even a clip with an acceptable average bandwidth may stall 
during playback because it contains bandwidth spikes. The spreadsheet 
indicates where spikes occur. 


Tuning Shockwave Flash 


After you generate a Shockwave Flash file and create the movie report, you 
must use the Flash Bandwidth Tuner to view bandwidth statistics and adjust 
the file's streaming bit rate. You can also use the Flash Bit Rate Calculation 
Spreadsheet to examine the file's bandwidth consumption frame-by-frame. 
You will need Microsoft Word and Microsoft Excel to use the spreadsheet. See 
the tuner online help for instructions on using the tuner and spreadsheet. 


Note 
These tools are in the RealSystem Authoring Kit at 
hetp://www.realnetworks.com/products/authkit/. 


Exporting Audio 


After you have created and tuned your Shockwave Flash file, export the movie 
soundtrack as a Windows AVI or Macintosh QuickTime file, setting 32x21 as 
the height and width attributes to minimize disk space use. Next, encode the 
AVI or QuickTime soundtrack in the RealAudio format with a RealNetworks 
encoding tool, using the file extension .rm. 
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Additional Information 
For more on audio production, see Chapter 4 beginning 
on page 43. For codec considerations in Flash, see 
“Dividing Bandwidth Between Shockwave Flash and 
RealAudio” on page 69. 


Delivering the Flash Presentation 


When your Shockwave Flash and RealAudio files are complete, you create a 
SMIL file that lists the URLs for these files. Chapter 7 beginning on page 79 
explains how to create the SMIL file. In its simplest form, the SMIL file 
specifies that the two files play in parallel: 
<smil> 
<body> 
<par> 
<audio src="rtsp://realserver.example.com:554/media/sound.rm”/> 
<animation src="rtsp://realserver.example.com:554/media/cartoon.swf"/> 


</par> 
</body> 
</smil> 


You can also use the SMIL file to define clickable hypertext links, create 
timing offsets between the clips, or add presentation information such as title, 
author, and copyright. Next, move the Shockwave Flash, RealAudio, and SMIL 
files to RealServer and link your Web page to the SMIL file. 


Additional Information 
For instructions on linking Web pages to clips on 
RealServer, see “Streaming Clips from RealServer” on 
page 158. 


Supporting RealPlayer 5.0 


As described in “Adding RealPlayer 5.0 Compatibility” on page 70, you can 
support RealPlayer 5.0 in a number of ways. The simplest means of delivering 
a 5.0-compatible presentation through a single URL is to create a SMIL file for 
RealPlayer G2 or higher as described above. Then create a Ram file (extension 
.ram) that looks like this: 
rtsp://realserver.example.com:554/media/animation.smil 

--stop-- 

pnm://realserver.example.com:7070/media/cartoon.swf+sound.rm 
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You next link your Web page to this Ram file with astandard HTTP hypertext 
link. Users with RealPlayer G2 or higher receive the SMIL-based presentation. 
Those with RealPlayer 5.0 receive the presentation defined below the --stop-- 
marker. Note that this second link uses the older PNA protocol and associates 
the animation and soundtrack through the “+” operator. 


Additional Information 
See “Creating a Ram File Manually” on page 165. To 
embed the presentation in a Web page, see Chapter 9 
beginning on page 129. 


Note 
In the examples above, the same soundtrack (sound.rm) 
is used for both RealPlayer 5.0 and RealPlayer G2 or 
higher. This works if the soundtrack uses a RealAudio 
5.0 codec or is a RealAudio G2 SureStream clip with the 
5.0 backwards-compatibility option. 
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ASSEMBLING A PRESENTATION WITH 
SMIL & 
When your multimedia presentation contains multiple clips—such 
as a slideshow and a video played together—you use Synchronized 
Multimedia Integration Language (SMIL) to coordinate the parts. 
Pronounced “smile,” SMIL uses a simple but powerful mark-up 
language for specifying how and when clips play. After writing the 
SMIL file, you put it on RealServer and link your Web page to it as 
described in Chapter 11, beginning on page 157. 


Tip 
If you have just one clip in your presentation, such as a 
single RealVideo clip, you don’t need to create a SMIL 
file. Just link your Web page to the clip as explained in 
Chapter 11. 


Additional Information 
Once you are familiar with SMIL, refer to “Appendix D: 
SMIL Quick Reference” beginning on page 207. 


Creating a SMIL File 


You can create a SMIL file (extension .smil) with any text editor or word 
processor that can save output as plain text. If you are familiar with HTML 
mark-up, you will pick up SMIL quickly. In its simplest form, a SMIL file lists 
multiple clips played in sequence: 


<smil> 
<body> 
<audio src="rtsp://realserver.example.com/one.rm”/> 
<audio src="rtsp://realserver.example.com/two.rm”/> 
<audio src="rtsp://realserver.example.com/three.rm”/> 
</body> 
</smil> 





79 


CHAPTER 7: Assembling a Presentation with SMIL RealSystem G2 Production Guide 





SMIL General Rules 


SMIL has many similarities to HTML, but also some important differences. 
When you create your SMIL file, keep the following general rules in mind. 


Mark-up Starts with <smil> and Ends with </smil> 


The SMIL mark-up must start with a <smil> tag and end with the </smil> 
closing tag. All other mark-up appears between these two tags: 
<smil> 


...all other SMIL mark-up... 
</smil> 


Body Section is Required but Header Section is Optional 


A SMIL file can include an optional header section defined by <head> and 
</head> tags. It requires a body section defined by <body> and </body> tags: 
<smil> 
<head> 
...optional section with all header mark-up... 
</head> 
<body> 
... required section with all body mark-up... 
</body> 
</smil> 


The header section is used to specify presentation information, as noted in 
“Adding Presentation Information” on page 95, and to define clip layout, as 
described in “Laying Out Multiple Clips” on page 99. 


Lowercase Text for Tags and Attributes 


SMIL tags and attributes must be lowercase. 


Some Tags Must Close with a Forward Slash 


A tag that does not have a corresponding end tag (for example, the <smil> tag 
has the end tag </smil>), must close with a forward slash. For example: 


<audio src="first.rm”/> 


Attribute Values Enclosed in Double Quotation Marks 


Attribute values, such as “first.rm” shown above, must be enclosed in double 
quotation marks. File names in SMIL must reflect the file name exactly as it 


appears on the server. They can use upper, lower, or mixed case. 
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SMIL Files Use the Extension .smi or .smil 


Save your SMIL file with the extension .smi or .smil. The latter extension (.smil) 
is preferred to avoid possible conflict with other files. Do not include spaces in 
the file name. For example, you can have the file my_presentation.smil but not 
the file my presentation.smil. 


Coded Characters Used in Header 


You need to use codes to add quotation marks, apostrophes, ampersands, or 
angle brackets to content in a SMIL header, such as a presentation title. See 
“Using Coded Characters” on page 98. 


HTML-Style Comments Allowed 


As in HTML, the SMIL comment tag starts with <!-- and ends with -->. The 
ending does not include a forward slash: 


<!-- This is a comment --> 


Indentation Recommended 


Although examples in this chapter indent SMIL tags to various levels to 
illustrate the SMIL structure, indentation is not required. Indenting your 
SMIL files like the examples shown below will help you keep track of the SMIL 
functions, though. 


Specifying Clip Locations 


To add a clip to the presentation, you include in the SMIL body section a clip 
source tag that describes the clip type and location: 


<audio src="rtsp://realserver.example.com:554/audio/first.rm” /> 
There are several clip source tags, as described in the following table. 


Clip Source Tags 














Clip Tag Used For 

animation Animation clips such as Shockwave Flash (swf). 

audio Audio clips such as RealAudio (.rm). 

img JPEG (.jpg), GIF images (.gif), or PNG images (.png). See also 
“Defining Image Options” on page 117. 

ref Any clip type not covered by other attributes, such as a RealPix file 
(.rp). 





(Table Page 1 of 2) 
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Clip Source Tags (continued) 











Clip Tag Used For 

text Static text clips (.txt). 

textstream Streaming RealText clips (.rt). 

video Video or other clips that display continuous motion, such as 
RealVideo (.rm). 





(Table Page 2 of 2) 


Additional Information 
For information on supported streaming formats, see 
“Choosing Media to Stream” on page 15. 


The clip source tag you use to specify a certain clip does not affect playback 
because RealPlayer determines the clip type through other means. Specifying a 
text clip with the <audio.../> tag, for example, does not prevent RealPlayer 
from determining that it’s a text clip. Although using the different clip tags 
helps you keep track of the clip types, you could specify all clips with <ref.../> 
tags, for example. 


Within each clip source tag, a mandatory src attribute lists the clip location. 
How you specify this location depends on whether you will stream the 
presentation with RealServer, download the clip from a Web server, or play 
clips back from a local computer. 


Linking to Clips on RealServer 


When a RealSystem presentation streams over a network, the clips reside on 
RealServer. Each source clip’s src attribute gives the clip’s URL: 


<audio src="rtsp://realserver.example.com:554/audio/first.rm” /> 
The following table explains the URL components in the example above. 


Contact your RealServer administrator to get the RealServer address, RTSP 
port, and directory structure. 
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RealServer URL Components 


Component Meaning 





rtsp:// RTSP streaming protocol. In contrast, URLs in Web pages 
start with http://. Although RealServer also supports 
HTTP, RealServer clips should always use RTSP. 





realserver.example.com | RealServer address. This varies with each RealServer. It 
typically uses an identifier such as realserver instead of 
www. Or it may use a TCP/IP address such as 
172.2.16.230 instead of a name. 





2554 RealServer port for RTSP connections. Port 554 is the 
default, so you can leave this out of URLs unless the 
RealServer administrator changed the RTSP port. If the 
port number is required, separate it from the address 
with a colon. 





/audio/ RealServer directory that holds the clip. The directory 
structure may be several levels deep. RealServer also uses 
“mount points” that invoke certain features, such as 
password authentication. Because these mount points 
appear to be directories in the URL, the request path does 
not mirror the actual directory path on the RealServer 
machine. The RealServer administrator can tell you the 
mount points and directories in the path. 








first.rm Clip file name. 





Creating Relative URLs 


If your presentation includes many clips that are on the same server, you can 
make each URL relative to a base target that you define in the header: 


<head> 
<meta name="base” content="rtsp://realserver.example.com/”/> 
</head> 
<body> 
<audio src="audio/first.rm”/> 
<audio src="audio/second.rm”/> 
<audio src="rtsp://realserver.real.com/audio/third.rm”/> 
</body> 


Because the third clip uses a full URL, the base target is ignored. For the first 
two clips, however, the src values are appended to the base target, effectively 
giving the clips these URLs: 


rtsp://realserver.example.com/audio/first.rm 
rtsp://realserver.example.com/audio/second.rm 
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If no base target is given, RealPlayer assumes that the clip paths are relative to 
the location of the SMIL file. In the example above, therefore, you could leave 
the base target out if the SMIL file itself resides in a directory that contains 
the audio subdirectory that in turn holds the RealAudio clips. RealPlayer 
requests the clips with the same protocol it used to request the SMIL file. 


Tip 
The relative syntax for SMIL files works like relative 
links in HTML, so you can use directory notation such 
as “../”. You can find additional information about this 
topic in an HTML reference guide. 


Linking to Clips on a Web Server 


To use a clip hosted on a Web server, use a standard HTTP URL such as the 
following in a clip source tag: 


<img src="http://www.example.com/images/logo.gif”/> 


URLs to clips on a Web server can also be relative to a base target as described 
above. Keep in mind that although a Web server can host any clip, a Web 
server cannot perform all the functions of RealServer. 


Additional Information 
See “Hosting a Presentation on a Server” on page 25 and 
“Limitations on Web Server Playback” on page 163. 


Linking to Local Clips 


If your presentation clips will reside on the user’s local computer (such as a 
multimedia tutorial included with a software application, for example), you 
include the SMIL file locally as well. The src attributes in the SMIL file list 
presentation clips in this format: 


src="audio/first.rm” 


This example is a local, relative link to a clip that resides one level below the 
SMIL file in the audio directory. For local access, you typically want to use 
relative links because you cannot be sure where users will place clips on their 
machines. 


Alternately, you can use absolute, local links to specify exact locations. The 
syntax for absolute links is the same as with HTML. It varies with operating 
systems, however, and you should be familiar with the directory syntax for the 
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system you’re using. For example, the following absolute link syntax works for 
Windows machines, but not UNIX or Macintosh: 


src="file://c:\audio\first.rm” 


Warning 
Microsoft Internet Explorer 3.0 tries to display local 
SMIL files as HTML. To support this browser, launch 
the presentation through a Ram file as described in 
“Creating a Ram File Manually” on page 165. 


Grouping Clips 


With the SMIL <seq> and <par> tags, you can create groups that structure your 
presentation. The following sections explain how to play clips in sequence or 
parallel, as well as how to repeat groups or clips within groups. 


Playing Clips in Sequence 


Use the <seq> tag to play clips in sequence. In the following example, the 
second clip begins when the first clip finishes. 
<seq> 
<audio src="audio/newsong.rm”/> 
<audio src="audio/oldsong.rm”/> 
</seq> 


If your presentation included just the clips above, you wouldn’t need to use 
the <seq> tag. You could simply list the clips in order and RealPlayer would 
play them in sequence. The <seq> tag is most commonly combined with <par> 
to create combinations of sequential and parallel clips. 


Playing Clips in Parallel 


You can play two or more clips at the same time through the <par> tag. For 
example, the following combines a RealVideo clip with a RealText clip: 
<par> 

<audio src="music/newsong.rm”/> 

<textstream src="lyrics/newsong.rt”/> 
</par> 


When you play clips in parallel, be sure that they do not exceed the 
presentation bandwidth as described in “Choosing a Target Bandwidth” on 
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page 33. When RealServer streams parallel groups, it ensures that the clips 
stay synchronized. If some video frames don’t arrive, for example, RealServer 
either drops those frames or halts playback until the frames arrive. 


Additional Information 
When multiple visual clips play in parallel, you need to 
define each clip’s playback region. For more 
information, see “Laying Out Multiple Clips” on page 
99. 


Ending a Parallel Group on a Specific Clip 


By default, a <par> group ends once all clips finish playing back. You can 
modify this with an end time as described in “Setting Begin and End Times” 
on page 89. Or you can use the endsync attribute to stop the group when a 
specific clip finishes playback: 

<par endsync=“first”> 

</par> 

first 

Use the attribute endsync="first” to stop the <par> group the first time a clip in 
the group ends playback. All other clips in the group stop playing at that 


point regardless of their playback status and any timing parameters specified 
for them. 


last 

The attribute endsync=“last” causes the <par> group to conclude when all clips 
have finished playing. Because this is the default value, you can omit the 
endsync attribute from the <par> tag to achieve this effect. 


id(clip id) 
The attribute endsync="id(clip id)” causes the <par> group to conclude when 
the specified clip reaches its end. All other clips in the group stop playing at 
that point regardless of their playback status and any timing parameters 
specified for them. The specified clip must have a corresponding id value in its 
source tag: 
<par endsync="id (vid) "> 

<video id="vid” src="videos/newsong.rm”/> 

<textstream src="lyrics/newsong.rt”/> 
</par> 
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Repeating a Clip or Group 


The repeat=“n" attribute makes a clip or group play a specified number of 
times. You can add it to a clip source tag, for example: 
<video src="videos/newsong.rm” repeat="4" /> 
You can also add it to a <seq> or <par> group to make the entire group repeat: 
<par repeat="3"> 

<audio src="music/newsong.rm”/> 

<textstream src="lyrics/newsong.rt”/> 
</par> 


In the following example, an audio clip within a <par> group plays twice. 
Assuming the audio lasts longer than the text stream, the <par> group ends 
when the audio clip concludes its second playback: 
<par> 

<audio src="music/newsong.rm” repeat="2"/> 

<textstream src="lyrics/newsong.rt”/> 
</par> 


In the following <seq> group, the second video plays only after the first video 
plays twice: 
<seq> 
<video src="videos/newsong.rm” repeat="2"/> 
<video src="videos/newsong2.rm”/> 
</seq> 


Combining <seq> and <par>Tags 


You can combine and nest <seq> and <par> tags as needed. Note that the 
organization of these tags greatly affects the presentation playback: 
<seq> 
clip 1 
<par> 
clip 2 
clip 3 
</par> 
clip 4 
</seq> 
In the example above, clip 1 plays first. When it finishes, clip 2 and clip 3 play 


together. When both clip 2 and clip 3 have finished, clip 4 plays. You get very 
different results, though, if you switch the <seq> and <par> groupings: 
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<par> 
clip 1 
<seq> 
clip 2 
clip 3 
</seq> 
clip 4 
</par> 


In this example, clip 1, clip 2, and clip 4 all begin at the same time. When clip 
2 finishes, clip 3 starts. The following figure illustrates the difference between 
these different groupings. 


Different Playback Results with <seq> and <par> Groups 


Example 1 2 
3=—> 
Example 2 


——— 
2j5——> (3 jp ——> 


4 


Specifying Timing 
SMIL timing elements let you specify when a clip or group starts playing and 
how long it plays. All timing elements are optional. If you do not set them, 
clips start and stop according to their normal timelines and their positions 
within <par> and <seq> groups. The easiest way to designate a time is with 
shorthand markers of h, min, s, and ms as illustrated in the following table. 


Timing Shorthand Examples 
Shorthand Example Value 


2.5h 2 hours, 30 minutes 


2.75min 2 minutes, 45 seconds 
(Table Page 1 of 2) 
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Timing Shorthand Examples (continued) 
Shorthand Example Value 


15.55s 15 seconds, 550 milliseconds 


670.2ms 670.2 milliseconds 
(Table Page 2 of 2) 





Tip 
Decimal values are not required. You can express two 
seconds as “2s” or “2.0s”, for example. 


Normal Play Time Format 

You can also express time elements in a hh:mmiss.xy format. Here, hh is hours, 
mm is minutes, ss is seconds, x is tenths of seconds, and y is hundredths of 
seconds. In this example: 


begin="02:34.0” 


the time value is 2 minutes, 34 seconds. If the value does not include a decimal 
point, RealPlayer takes the last value to be seconds. So it reads the following 
value as 2 minutes, 34 seconds rather than as 2 hours, 34 minutes: 


begin="02:34” 


Setting Begin and End Times 


The begin attribute works for any clip or group. You can use it to start a clip at 
a specific point within the timeline: 


<video src="videos/newsong.rm” begin="20.5s” /> 


Were this clip in a<par> group, the begin attribute would start the clip playing 
back 20.5 seconds after the group becomes active. If the clip were in a <seq> 
group, the attribute would delay the clip’s normal playback by inserting 20.5 
seconds of blank time before the clip starts. Hence timing is relative to the 
start of the <seq> or <par> group, not the start of the overall presentation. 


Additionally, you can set an end attribute alone or combined with a begin 
attribute as shown here: 


<video src="videos/newsong.rm” begin="20.5s” end="62.7s" /> 


In this example, the clip ends at 62.7 seconds into its part of the presentation 
timeline, playing a total of 42.2 seconds regardless of the length of its internal 
timeline. If the video’s internal timeline is shorter (30 seconds, for example) 
the fill attribute determines what happens onscreen after the video stops 
playing but before the end time is reached. 
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Additional Information 


See “Setting a Fill” on page 92. 


Using Begin and End Times with Groups 


You can use begin or end with a <par> or <seq> group: 

<par begin= “5s” end= “3.5min”> 

</par> 

This begin value delays group playback until 5 seconds after the preceding 
group or clip finishes. The end time means all clips in the group stop playing 
after 3.5 minutes regardless of their states. If all clips reach their normal 


conclusion by 3 minutes and 20 seconds after the group starts, for example, 
the next group or clip starts after 10 seconds of blank time. 


If you use an end time and a repeat attribute as described in “Repeating a Clip 
or Group” on page 87, the group repeats only after the end time elapses. You 
should not set an end time along with an endsync attribute in a <par> group, as 
this sets up conflicting end times. For more on endsync, see “Ending a Parallel 
Group on a Specific Clip” on page 86. 


Setting Internal Clip Begin and End Times 


The clip-begin and clip-end attributes specify a clip’s internal timing marks 
where playback begins and ends. You can use them with clips that have 
internal timelines, such as audio, video, and animation. Do not use them with 
groups or static clips such as still images. Here is an example: 


<video src="videos/newsong.rm” clip-begin="10.5s” clip-end="50.7s"/> 


Here, the clip starts playing at its internal 10.5-second mark rather than at its 
normal beginning. It stops when it reaches its 50.7-second mark, playing for a 
total of 40.2 seconds. 


Note 
Do not use clip-begin and clip-end for a live broadcast or 
when playing clips back from a Web server. For more 
information, see “Limitations on Web Server Playback” 
on page 163 and “Using SMIL with a Broadcast” on page 
176. 
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Combining clip-begin and clip-end with begin and end 


You can combine clip-begin and clip-end attributes with begin and end 
attributes. Here, a begin time has been added to the clip example shown above: 


<video src="videos/newsong.rm” clip-begin="10.5s” clip-end="50.7s” begin="5s"/> 


The begin time delays the clip’s normal starting point by five seconds. When 

this time elapses, the clip starts at its 10.5 second internal timeline marker, 

then plays for 40.2 seconds. In this case, theclip-end attribute determines how 

long the video is active. But you could also add anend attribute as shown here 

to modify this behavior: 

<video src="videos/newsong.rm” clip-begin="10.5s” clip-end="50.7s” begin="5s” 
end="50s”" /> 


Combined with begin, the end value of 50 means the clip’s “window” within 
the presentation is 45 seconds. Because the clip stops playing after 40.2 
seconds, there is an extra 4.8 seconds during which the clip does not play but 
remains active. How the video window appears during these final seconds 
depends on the fill attribute, as described in “Setting a Fill” on page 92. 


Setting Durations 
The dur attribute controls how long a clip or group is active after it starts to 
play back. It is useful with graphic images, as shown in this example: 
<img src="graphics/poster.jpg” dur="14.5s”/> 
This dur time makes the graphic disappear 14.5 seconds after it appears. You 
can also use dur in place of end. For example, in the following clip: 
<video src="videos/newsong.rm” begin="20.5s” end="62.7s" /> 
you can substitute a dur attribute for the end attribute to achieve the same 
result: 
<video src="videos/newsong.rm” begin="20.5s” dur="42.2s”"/> 


In both examples, the clips stop playback 42.2 seconds after starting. With the 
end attribute, the total playing time is the end value minus the begin value. The 
dur attribute ignores the begin value, stopping the clip 42.2 seconds after it 
starts. Use either end or dur, therefore, depending on how you want to measure 
time. Do not use both attributes in the same tag, however. 
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Additional Information 
The dur attribute can function like end in a group, too. 
For more information, see “Using Begin and End Times 
with Groups” on page 90. 


Setting a Fill 


The fill attribute determines what happens to the clip immediately after it 
plays to its normal end point, or its specified end time or duration elapses. 
The fill value can be remove or freeze. 


remove 
The default value fill-“remove” removes the clip. When this attribute is used 
with a still image, the image disappears once the end time has elapsed. 


freeze 

Use fill="freeze” to freeze the clip on its last frame. When used with a video, the 
video’s last frame stays on the screen. Suppose that you have a 20-second video 
and specify a 30-second duration with freeze: 


<video src="videos/newsong.rm” dur="30s” fill="freeze” /> 


After the video plays, its last frame displays for 10 seconds. The video 
disappears when the end time elapses. The fill="freeze” attribute has no effect 
on audio. Do not use fill=“freeze” for a graphic image that also uses a dur 
attribute. 


Clip Timing Example 
The following example shows two audio clips with different timing options: 
<par> 
<audio src="song1.rm” clip-begin="30.4s” dur="30s”"/> 
<audio src="song2.rm” begin="28s” clip-begin="2.4s” clip-end="13.7s"/> 
</par> 


The timing options modify the <par> tag so that the two clips start at different 
times. The first clip begins to play immediately, but starts at 30.4 seconds into 
its timeline, playing for exactly 30 seconds. 


The second clip is delayed for 28 seconds. That means it overlaps the first clip 
by 2 seconds. It starts at 2.4 seconds into its timeline and ends at 13.7 seconds 
into its timeline, thus playing for 11.3 seconds. The total playing time for this 
group is 30 seconds for the first clip, plus 11.3 seconds for the second clip, 
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minus the 2 second overlap: 39.3 seconds. The following figure illustrates the 
relationships of the clip timelines to the overall presentation timeline. 


Clip Timing Example 


Presentation 
Timeline 
a — cn 


11.3 > 







Song2.rm 


Switching Between Alternate Choices 


With the <switch> tag, you can specify multiple options that RealPlayer can 
choose between. The <switch> group specifies any number of choices in this 
form: 

<switch> 


<choice1 test-attribute=“value1”/> 
<choice2 test-attribute=“value2”/> 


</switch> 


RealPlayer looks at choices in order, evaluating each test attribute and its 
value to determine which clip to choose. The choices are typically clip source 
tags such as <video test-attribute=“value”/>, but RealPlayer can also choose 
between groups when test attributes appear in <par> or <seq> tags. 


Note 
Every RealPlayer must have a viable choice within a 
<switch> statement. RealPlayer will not play any clip in 
the <switch> group if it finds no satisfactory test 
attribute. The following sections explain how to 
guarantee that every RealPlayer has a viable option. 
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Setting Language Choices 


When the <switch> group test attribute is system-language, each source clip is 
for a different language. The following example shows a video slideshow with 
separate audio narrations in French, German, Spanish, and English. Based on 
the language preference set through its Options menu, as well as the system- 
language code defined in the SMIL file, RealPlayer chooses a clip to play: 
<par> 
<video src="slides/seattle.rm” /> 
<!-- select audio based on RealPlayer language preference setting --> 
<switch> 
<audio src="french/seattle.rm” system-language="fr"/> 
<audio src="german/seattle.rm” system-language="de" /> 
<audio src="spanish/seattle.rm” system-language="es”/> 
<audio src="english/seattle.rm”/> 
</switch> 
</par> 


Because the last option does not have a test attribute, a RealPlayer that does 
not have French, German, or Spanish explicitly set as its preferred language 
chooses the English clip regardless of its actual language setting. RealPlayer 
evaluates options in order, so the last option should be, as shown in this 
example, a default language that applies if no other option is viable. If you list 
no default option and certain RealPlayers prefer languages other than the 
ones you list, those RealPlayers will not play any of the clips. 


Additional Information 
Appendix F starting on page 223 lists the system- 
language codes such as “fr” you use to designate content 
in different languages. 


Setting Bandwidth Choices 


To serve different clips to viewers with different connection speeds, use the 
<switch> tag to define options each RealPlayer can choose based on its 
available bandwidth. As shown below, you can group clips with <par> tags, 
using the system-bitrate attribute to list the approximate bandwidth (in Kbps) 
each group consumes: 
<switch> 
<par system-bitrate="75000"> 
<!--for dual isdn and faster--> 
<audio src="audio/newsong1.rm”/> 
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<video src="video/newsong1.rm”/> 
<textstream src="lyrics/newsong1.rt”/> 


</par> 

<par system-bitrate="47000"> 
<!--for single isdn--> 
<audio src="audio/newsong2.rm”/> 
<video src="video/newsong2.rm”/> 
<textstream src="lyrics/newsong2.rt”/> 


</par> 

<par system-bitrate="20000"> 
<!--for 28.8 modems--> 
<audio src="audio/newsong3.rm”/> 
<video src="video/newsong3.rm”/> 
<textstream src="lyrics/newsong3.rt”/> 


</par> 
</switch> 


Always list system bandwidth options from highest to lowest. RealPlayer 
evaluates options in the order listed, selecting the first viable option even if 
subsequent options suit it better. So if the 28.8 Kbps option is first, a 
RealPlayer with a dual-ISDN connection will choose that option because it is 
the first viable option listed. 


Also ensure that the last option satisfies the lowest bandwidth connection you 
want to support. Ifyou do not list an option suitable for 28.8 Kbps modems, 
for example, RealPlayers connected through those modems will not play the 
presentation. 


Additional Information 
“Writing Complex SMIL Switch Statements” on page 
199 explains how to use <switch> with SureStream clips, 
as well as how to test for both language and bandwidth. 


Adding Presentation Information 


The SMIL file header can use <meta> tags to list presentation information 
such as title, author, and copyright: 
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<head> 
<meta name="title" content="Bob and Susan Discuss Streaming Media"/> 
<meta name="author" content="RealNetworks Media Productions"/> 
<meta name="copyright" content="(c)1998 RealNetworks"/> 
<meta name="abstract" content="Bob and Susan, two Internet technology 
experts, discuss the future of streaming media."/> 
</head> 


This example defines a title, author, copyright, and abstract. You can define 
other values as well, such as an e-mail address, simply by adding an attribute 
such as name="email”. This information displays when the user gives the 
RealPlayer Help>About this Presentation command. In addition, the title 
displays at the top of the RealPlayer window and in the run list under the 
RealPlayer File menu. 


Note 
Name values, as in name=“title”, must be lowercase. 
When defining long content such as an abstract, don’t 
use line breaks or tabs within a content value. 


Managing the Playlist 


In addition to the presentation information, RealPlayer keeps a playlist of clip 
titles. Through this playlist, users can play different parts of the SMIL 
presentation. The following example shows the same header information as 
above, but adds titles for each video clip in the body section: 


<smil> 
<head> 
<meta name="title" content="Bob and Susan Discuss Streaming Media"/> 
<meta name="author" content="RealNetworks Media Productions"/> 
<meta name="copyright" content="(c)1998 RealNetworks"/> 
<meta name="abstract" content="Bob and Susan, two Internet technology 
experts, discuss the future of streaming media."/> 
</head> 
<body> 
<seq> 
<video src="clip1.rm" title="Bob Expounds his View"/> 
<video src="clip2.rm" title="Susan Responds with Another Perspective" /> 
<video src="clip3.rm" title="Summary: A Look at the Future"/> 
</seq> 
</body> 
</smil> 
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The titles for the individual clips appear in RealPlayer’s pull-down playlist as 
illustrated in the following figure. The user can also view the playlist with 
RealPlayer’s File>Playlist command. 


RealPlayer’s Pull-Down Playlist Showing Clip Titles 


Playlist: [Bob Expounds his View x] 


‘Bob Expounds ‘y 





Susan Responds with Another Perspective 
Summary: & Look at the Future 





Only the clip titles affect the playlist, but you can also define an author, 
copyright, and abstract for each clip. As illustrated below, clip information 
appears when the RealPlayer user gives the Help>About this Presentation 
command while the clip plays. 


Presentation and Clip Information 


Presentation 





Title: Bob and Susan Discuss Streaming Media 
Author: RealNetworks Media Productions 
Copyright: (c)1998 RealNetworks 

Abstract: Bob and Susan, two Internet 
technology experts, discuss the future of 
streaming media. 





Note that in this figure, the clip information section shows the clip title 
defined in the SMIL file, but also includes author and copyright information 


not defined through SMIL. The author and copyright information is encoded 
in the clip. 


Tips for Defining Clip Information 


The following points explain the relationship between clip information set 
through SMIL and information encoded in a clip. 


+ Clips may include their own title, author, copyright, and abstract 
information. With RealVideo, for example, this information is encoded 
within the clip. For RealPix, it is set within the RealPix text file. 
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When you encode a clip with RealProducer, the information you enter in 
RealProducer’s Description field becomes the clip abstract. 


You can override any title, author, copyright, or abstract information 
encoded in a clip by adding title, author, copyright, and abstract attributes 
to the clip’s SMIL source tag: 


<ref src="...” title=“title” author="name” copyright=“copyright” 
abstract=“abstract” /> 


To make the playlist useful, always define a title for each clip through 
SMIL. RealPlayer reads the SMIL titles when the presentation begins. It 
reads a clip’s encoded title only when the clip starts playback. So if you 
define titles through SMIL, RealPlayer can immediately build a playlist 
that allows the user to choose different clips. 


Only title, author, copyright, and abstract attributes are supported for clips. 
For the entire presentation, however, you can define any information 
through the header section <meta.../> tags. See “Adding Presentation 
Information” on page 95 for more information. 


For a parallel group, use title, author, copyright, and abstract attributes in 
the <par> tag instead of the clip source tags. Clip titles are ignored, and 
only the group title shows in the playlist. For more on <par>, see “Playing 
Clips in Parallel” on page 85. 


A title, author, copyright, or abstract attribute in a <seq> tag is ignored. This 
information must be defined for individual clips or parallel groups. 


Although it’s easier to set clip information through SMIL, it’s good 
practice to encode the title, author, and copyright information in the clip 
as well. This preserves the clip information in case you stream the clip 
without using a SMIL file. 


Using Coded Characters 


In a header, SMIL interprets quotation marks, apostrophes, ampersands, and 


angle brackets as syntax markers.To have these characters show up as text in 


RealPlayer, you use codes in the header. As shown in the following table, codes 
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begin with an ampersand (“&”) and end with a semicolon (“;”). SMIL 
interprets these codes the same way as popular Web browsers. 


SMIL Coded Characters 























Code Character Example 
&quot; quotation mark " 

&amp; ampersand & 
&apos; apostrophe > 

&lt; left angle bracket ("less than” sign) < 

&gt; right angle bracket ("greater than” sign) | > 





For example, to add the following as a title: 
“Multimedia’s <smil> & you” 
You enter this in the SMIL file header: 


<meta name="title” content= 
"&quot;Multimedia&apos;s &lt;smil&gt; &amp; you&quot;”/> 


Laying Out Multiple Clips 


If your presentation plays only one clip at a time, you do not need to create a 
layout. Each clip automatically plays in the main RealPlayer window, the 
window resizing automatically for each new clip. If you want to keep the 
playback area stable in size as different clips play back, or if your presentation 
displays several clips at a time, you can define playback areas called “regions” 
within the main RealPlayer window: 


1. In the SMIL file header, you create a <layout> group, using <region> tags to 
name playback regions and define their sizes and locations within the 
RealPlayer main window. See “Defining the Layout” below. 


2. In the SMIL file body, you use region attributes to specify which source 
clips play in which regions. See “Assigning Clips to Regions” on page 107. 


Additional Information 
See “Laying out SMIL Presentations” on page 145 for 
instructions on using RealPlayer’s Netscape plug-in or 
ActiveX control to lay out the presentation in a Web 
page instead of in RealPlayer. 
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Defining the Layout 


When you lay out regions, you create a root-layout region that defines the size 
of the RealPlayer main window. You then create other regions using a simple 
coordinate system measured across and down from the top, left-hand corner 
of the root-layout region. All measurements are in pixels or percentages, with 
zero pixels as the default. The following table lists the attributes that define 
region size and placement. 


Region Size and Placement Attributes 











Attribute Sets Pixel Example Percentage Example 
top offset from top of window top="60" top="10%”" 

left offset from left side of window | left="120” left="20%”" 

width region width width="240" | width="40%” 
height | region height height="180" | height="30%”" 














The next figure illustrates the layout of a single playback region within a root- 
layout region. 


Basic Region Layout 





Setting the Root Layout Region 


With the <root-layout.../> tag, you specify the size of the entire playback area 
in pixels (percentages are not accepted for the root-layout region). You cannot 
display images or play clips in the root-layout region, as it is meant to set the 
overall playback area. The example shown below creates a root-layout region 
250 pixels wide by 230 pixels high. When the presentation begins, the 
RealPlayer window expands to this size. Other regions measure their top and 
left offsets from the upper, left-hand corner of this root-layout region: 
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<head> 
<layout> 
<root-layout width="250” height="230"/> 
...other regions defined here... 
</layout> 
</head> 


Note 
Although you can omit root-layout to have RealPlayer 
calculate the playback area based on the sizes of the 
other regions, it is better to define root-layout to avoid 
unexpected results. 


Defining Playback Regions 


You create playback regions for clips with <region> tags. These regions must 
lay within the root-layout region. Any part of a region that lays outside the 
root-layout region is cut off. Each <region.../> tag must define top, left, width, 
and height attributes. The example below defines two regions named 
“videoregion” and “textregion”: 
<head> 
<layout> 
<root-layout background-color="maroon” width="250” height="230"/> 
<region id="videoregion” top="5" left="5" width="240” height="180"/> 
<region id="textregion” top="200” left="5" width="240" height="20"/> 
</layout> 
</head> 


In this example, both regions are offset 5 pixels to the right of the root-layout 
region’s left edge. The video region displays 5 pixels down from the top of the 
root-layout region, and the text region displays 200 pixels down. The following 
figure illustrates this placement. 
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SMIL Sample Layout with Video and Text Windows 
—S= a 














Top Stories Tonight... 
240 


Tips for Defining Regions 
Note the following about SMIL regions: 


- All regions used in the presentation must be defined in the header. All 
regions are created at the beginning of the presentation, so regions 
containing background colors as described in “Adding a Background 
Color” on page 103 may obscure other regions they overlap. 


- Using region transparency and the z-index attribute, you can emulate 
dynamic creation and destruction of regions. For details, see “Hiding 
Regions with z-index” on page 197. 


- To use a graphic such as a GIF, JPEG, PNG image as a background, define 
a playback region the same size as the root-layout region. Display the 
image in this region and use the z-index attribute to make it display 
behind other regions. For more information, see “Ordering Overlapping 
Regions with z-index” on page 105. 


Using Percentage Values for Regions 


For a region’s height, width, and offset measurements, you can use 
percentages that reflect a fraction of the root-layout region’s size. The 
following example uses percentages to define playback areas similar to those 
shown in the sample above: 
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<head> 
<layout> 
<root-layout background-color="maroon” width="250” height="230"/> 
<region id="videoregion” top="2%” left="2%" width="96%”" height="78%" /> 
<region id="textregion” top="80%” left="2%" width="96%”" height="18%" /> 
</layout> 
</head> 


Tips for Using Percentage Values 


Note the following when using percentage values to define regions: 


- You must include a root-layout region defined in pixels when specifying 
region measurements in percentages. 


- You can mix pixels and percentages. You could define the top and left 
offset measurements in percentages, for example, while specifying the 
width and height measurements in pixels. 


- You can use whole and decimal values for percentages. For example, the 
values “4%” and “4.5%” are both valid. 


- Because a region is clipped at the boundary of the root-layout region, no 
percentage value can effectively be more than 100%. 


Adding a Background Color 


By default, the root-layout region is black. All other regions use transparency 
as their default. In the SMIL layout, you can specify another background color 
for any region: 
<layout> 

<root-layout background-color="maroon”/> 

<region id="videoregion” background-color="silver”.../> 

<region id="textregion” background-color="#C2EBD7”.../> 
</layout> 


For the color value, use any RGB hexadecimal value (FRRGGBB) supported by 
HTML, or one of the following predefined color names, listed here with their 
corresponding hexadecimal values: 


white (#FFFFFF) silver (HCOCOCO) gray (#808080) black (#000000) 
yellow (#FFFFOO) fuchsia (#FFOOFF) red (#FFO000) maroon (#800000) 
lime (#00FFOO) olive (#808000) green (#008000) purple (#800080) 
aqua (#OOFFFF) teal (#008080) blue (HOOOOFF) —_ navy (#000080) 
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Using Transparency 

A region is transparent if you do not define its background color. You can also 
specify “transparent” as a region background color. Transparency means that 
the region is not visible until a clip starts to play in it. However, this is not true 
transparency. If the clip contains transparency too, you will not see through 
the clip and its region to the root-layout region. 


Fitting Clips to Regions 
When a clip is encoded at a size different from the playback region’s defined 
size, the fit attribute determines how the clip fits the region: 
<region id="videoregion” width="128”" height="64” fit="meet” /> 
The fit attribute uses one of the values described in the following table. If you 
do not specify a fit attribute, the clip uses the default value hidden. In no case 
will a clip display outside the boundaries of its region. 

Region Fit Attributes 


Attribute Action 





Fill Scale the clip so that it fills the region exactly. Image distortion 
occurs if the encoded clip and playback region have different 
height-to-width ratios. 





hidden Keep the clip at its encoded size and place it at the region’s upper, 
(default) | left-hand corner. If the clip is smaller than the region, fill 
remaining space with the region’s background color. If the clip is 
larger than the region, crop out the area that doesn’t fit. 





meet Place the clip at the region’s upper, left-hand corner. Scale the clip 
and preserve its height/width ratio until one dimension is equal to 
the region’s size and the other dimension is within the region’s 
boundaries. Fill empty space with the region’s background color. 





slice Place the clip at the region’s upper, left-hand corner. Scale the clip 
and preserve its height/width ratio until one dimension is equal to 
the region’s size and the other dimension over flows the region’s 
boundaries. Crop the overflow. 








The following figure illustrates the effect that fit attributes have on a source 
clip that plays in windows with different sizes and aspect ratios. 
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Different Clip Scaling Results Based on “fit” Attribute 


Fill Hidden 
Encoded 
Clip Meet mn Slice . 
Tip 


When scaling clips inside a region, keep in mind that 
different media scale with different results. A video 
scaled larger than its encoded size may not look good. 
Vector-based media such as Flash animation scale more 
easily to fit different region sizes, however. Also, scaling 
a clip consumes CPU on the RealPlayer machine. 


Ordering Overlapping Regions with z-index 


If regions overlap, you can use the z-index attribute to determine which 
regions appear in front. The following example creates a video region that 
overlaps an image region: 
<layout> 
<root-layout background-color="gray” width="280” height="220"/> 
<region id="image” top="10” left="10”" width="260” height="200" z-index="0"/> 
<region id="video” top="20” left="20" width="240" height="180”" z-index="1"/> 
</layout> 


This example defines a gray root-layout region 220 pixels high by 280 pixels 
wide. A smaller image region is centered within this gray background. Its z- 
index value of zero makes it display behind all other regions, but not behind 
the root-layout region. The video region centered in the image region appears 
on top of that region because of its higher value for z-index. Another region 
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could overlap the video region with z-index set, for instance, to 2, 5, or 29. The 
following figure illustrates these regions. 


Regions Overlapping through z-index 

















Tips for Defining Z-Index Values 
The following are points to observe when using z-index: 


- The root-layout region is always behind all other regions and does not use 
z-index. 


+ The z-index values can include negative integers (such as -4), 0 (zero), and 
positive integers (such as 5). A region with a z-index value of -4, for 
example, displays behind a region with a value of 0, which displays behind 
a region with a value of 5. 


+ The default value of 0 (zero) applies if you don’t specify z-index. 


- Using strictly sequential values such as 0, 1, 2, 3, 4 helps you keep track of 
the layers, but is not necessary. A sequence such as 0, 1, 6, 19, 34 works just 
as well, and leaving gaps in the sequence makes it easier to insert layers 
later. 


+ Nonoverlapping clips can have the same values. Side-by-side videos can 
both have z-index="3”, for example. 


- When overlapping clips have the same value, the clip that starts later in 
the presentation appears in front. 
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Additional Information 
See “Hiding Regions with z-index” on page 197 for 
information on using z-index to make regions appear to 
come and go dynamically. 


Assigning Clips to Regions 


After you define the layout in the header section as described in“Defining the 
Layout” starting on page 100, you use region attributes within source tags to 
associate each clip with a region. In the following example, the video and text 
clips are assigned to the video and text regions defined in the header: 


<smil> 
<head> 
<layout> 
<root-layout background-color="maroon” width="250” height="230"/> 
<region id="videoregion” top="5" left="5" width="240”" height="180"/> 
<region id="textregion” top="200” left="5" width="240" height="20"/> 
</layout> 
</head> 
<body> 
<par> 
<video src="video.rm” region="videoregion”/> 
<audio src="audio.rm” /> 
<textstream src="text.rt” region="textregion” /> 
</par> 
</body> 
</smil> 


You can reuse regions by assigning sequential clips to them. For example, you 
can play a video clip in a region, then display another clip in that region after 
the first clip finishes. Don’t assign the same region to two clips that play at 
the same time, however. You don’t assign audio clips to regions at all because 
audio does display on the screen. 


SMIL Layout Example 


The following example displays three regions: a news region, a video region, 
and a stock ticker region. The news and video regions are arranged side by side 
at the top of the RealPlayer display window. The stock ticker region appears 
below them. 
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<smil> 
<head> 
<!--presentation with 2 text clips and 1 video clip--> 
<meta name="title” content="News of the Week” /> 
<layout> 
<root-layout width="430" height="165"/> 
<region id="newsregion” top="0" left="0”" width="250" height="144"/> 
<region id="videoregion” top="0" left="250" width="180" height="144"/> 
<region id="stockregion” top="145”" left="0" width="430" height="20"/> 
</layout> 
</head> 
<body> 
<par> 
<!--play these 3 clips simultaneously--> 
<textstream src="news.rt” region="newsregion”/> 
<video src="newsvid.rm” region="videoregion”/> 
<textstream src="stocks.rt” region="stockregion” /> 
</par> 
</body> 
</smil> 


The following figure illustrates the design of these regions. 


SMIL Sample Layout with Text, Video, and Stock Ticker Windows 
430 


Company Press Release 

Polar Bear Airlines to Lease 737 Jet 
DENVER--(Business Wire)--Aug. 12, 1998- 
-Denver-based Polar Bear Airlines 


165 


(Nasdaq:Plbr - news) today announced an 
agreement to lease a 737-200 jet from 
Interjet Aviation Investors LLC, Northfield, 
nS 9’ 
Nasdaq 1825.26 +32.56 (+1.82%) S&P 500 1082.84 





Linking to Other Media 


A SMIL file can define links to other media. A video might link to a second 
video, for example. When the viewer clicks the link, the second video replaces 
the first. Or the video could link to an HTML page that opens in the viewer's 


browser. You can even define areas as hot spots with links that vary over time. 
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The bottom corner of a video can link to a different URL every ten seconds, for 


instance. 


Note 
Some clips can also define hyperlinks. A RealText clip, 
for example, can define hyperlinks for portions of text. 
When a viewer clicks an area where a clip link anda 
SMIL file link overlap, the SMIL link is used. 


Making a Source Clip a Link 


The simplest type of link connects an entire source clip to another clip. As in 
HTML, you define the link with <a> and </a> tags. But whereas you enclose 
text between <a> and </a> in HTML, you enclose a clip source tag between <a> 
and </a> in SMIL: 
<a href="rtsp://realserver.example.com/video2.rm”> 

<video src="video.rm” region="videoregion”/> 
</a> 
The example above links the source clip video.rm to the target clip video2.rm. 
When a viewer moves the cursor over the source clip as it plays, the cursor 
turns to a hand icon to indicate that the clip is a link. When the viewer clicks 
video.rm as it plays, video2.rm replaces it. The URL begins with rtsp:// if the 
linked clip streams to RealPlayer from RealServer, or http:// if the file 
downloads to the browser from a Web server. When targeting a browser, 
include the show attribute as described below. 


Additional Information 
For information on RTSP URLs, see “Linking to Clips 
on RealServer” on page 82. 


Targeting RealPlayer or a Browser 


An <a> tag or <anchor> tag (see “Defining Hot Spot Links” on page 110) can 
include a show attribute that determines where a linked clip displays: 
<a href="http://www.example.com/index.htm” show="new”> 
<video src="video.rm” region="videoregion”/> 
</a> 
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replace 

The default attribute show="replace” causes the linked clip to replace the 
source clip in RealPlayer. This default behavior also occurs if you do not 
include the show attribute in the link. The following are important differences 
between RealPlayer and Web browsers to keep in mind when creating links: 


- RealPlayer does not include a Back button that allows the viewer to return 
to the link source clip after clicking the link. 


+ Clicking a link to another SMIL file or clip removes any existing regions. If 
you have three regions defined and the viewer clicks a link in one region, 
for example, the target clip replaces all clips in all regions. You can 
preserve regions by targeting a SMIL file that defines the same set of 
regions. You cannot preserve the timeline positions of clips playing in 
those regions when the viewer clicks the link, however. 


Tip 
RealNetworks has created an extension to SMIL that lets 
you open a linked presentation in a new RealPlayer 
window. For more information, see “Popping Up New 
RealPlayer Windows” on page 121. 


Additional Information 


“Linking to a SMIL File” on page 113. 


new, pause 

The values new and pause both open the linked clip in the viewer’s default 
browser. The source clip continues to play in RealPlayer if you use show="new”. 
With show="pause”, the source clip pauses in RealPlayer. The viewer can restart 
playback at any time, though, by clicking RealPlayer’s Play button. 


Use either show="new” or show="pause” to open a Web page or another clip 
viewable within a browser. You can use these attributes to link a RealSystem 
presentation to your home page, for example. Do not use them to link to 
another clip played in RealPlayer, however, such as a SMIL file or a RealVideo 
clip. 


Defining Hot Spot Links 


Within a SMIL file you can define hot spots using an <anchor> tag. Whereas 
the <a> tag turns the entire source clip into a link, the <anchor> tag turns only 
a defined area into a link. With <anchor> tags you can create links similar to 
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those in HTML image maps. But SMIL links can be temporal as well as spatial. 
A link might be valid for just ten seconds during a source clip’s timeline, for 
instance. 


Setting an Anchor 


The <anchor> tag differs from the <a> tag in that you place it within the clip 
source tag rather than before it: 
<video src="video.rm” region="videoregion”> 
<anchor href="rtsp://realserver.example.com/video2.rm” .../> 
</video> 


An <anchor> tag ends with a closing slash. But the clip source tag does not end 
with a closing slash as it normally would. Instead, the source tag and its 
subsequent <anchor> tags are followed by a closing source tag, such as </video>. 
The <anchor> tag includes an href attribute that uses rtsp:// if the linked clip 
streams from RealServer, or http:// if the file downloads to the browser froma 
Web server 


Additional Information 
For information on RTSP URLs, see “Linking to Clips 
on RealServer” on page 82. To target a browser with a 


link, see “Targeting RealPlayer or a Browser” on page 
109. 


Defining Spatial Coordinates 


The <anchor> tag’s coords attribute defines spatial coordinates for the hot spot 
rectangle. Coordinate values in pixels or percentages define the rectangle’s 
offset from the upper, left-hand corner of the source clip as shown in this 
example: 


<video src="video.rm” region="videoregion”> 
<anchor href=”...” coords="20,40,80,120"/> 
</video> 


The coordinate values for the hot spot rectangle follow this order: 
1. left side pixel or percentage value 
2. top pixel or percentage value 
3. right side pixel or percentage value 


4. bottom pixel or percentage value 
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The sample above uses pixel values to define a hot spot 60 pixels wide (80 
pixels minus 20 pixels) 80 pixels high (120 pixels minus 40 pixels). It produces 
a hot spot like that shown in the following figure. 


Hot Spot (Hyperlink) Defined with SMIL 





Percentage Values 

The coords attribute can also use percentage values to create hot spots relative 
to the source clip’s size. The following sample places in the center of the 
source clip a hot spot that is a quarter the size of the source clip: 


<video src="video.rm” region="videoregion”> 
<anchor href="...” coords="25%,25%,75%,75%" /> 
</video> 


The following table lists sample percentage coordinates that define hot spots 
for a source clip. Each hot spot is a quarter the size of the source clip. 


Sample Hot Spot Percentage Coordinates 
Hot Spot Rectangle Position Coordinate Attribute 
Upper, left-hand quadrant coords="0,0,50%,50%” 
Upper, right-hand quadrant | coords="50%,0,100%,50%” 
Lower, left-hand quadrant coords="0,50%,50%,100%” 
Lower, right-hand quadrant coords="50%,50%,100%,100%” 
Center coords="25%,25%,75%,75%” 























Tips for Defining Anchor Coordinates 
Note the following when defining hot spots: 


- You can mix pixels and percentages. For example, the coordinates 
“50,50,100%,100%” place the hot spot’s left and top boundaries in and 
down 50 pixels from the source clip’s upper, left-hand corner, respectively. 
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But the hot spot’s right and bottom boundaries extend to the source clip’s 
right and bottom edges, respectively, no matter the source clip’s size. 


+ Values such as “30,30,10,10” are ignored. Here, the hot spot’s left side is 
defined as farther to the right than its right side. As well, the top is 
defined to be below the bottom. 


- You can use whole and decimal values for percentages. For example, the 
values “4%” and “4.5%” are both valid. 


- Ahot spot defined to extend beyond the source clip is clipped at the clip’s 
edge. For example, if the hot spot has coordinates “50,50,300,300” but the 
source clip is 200 by 200 pixels, the hot spot’s effective coordinates are 
“$0,50,200,200”. For this reason, no percentage value can effectively be 
more than 100%. 


Setting Temporal Coordinates 


In addition to defining spatial coordinates, the <anchor> tag can set temporal 

attributes that specify when the link is active. If you do not include temporal 

attributes, the link stays active as long as the source clip appears on screen. To 
add timing attributes, use the SMIL begin and end values. (You cannot use dur, 
clip-begin, or clip-end.) 


The following example creates two temporal links for the clip video.rm. The 
first link is active for the first five seconds of playback. The second link is 
active for the next five seconds. Because no spatial coordinates are given, the 
entire video is a link: 
<video src="video.rm” region="videoregion”> 

<anchor href="rtsp://.../video2.rm” begin="0s”" end="5s"/> 

<anchor href="rtsp://.../video3.rm” begin="5s” end="10s"/> 
</video> 


Additional Information 
See “Setting Begin and End Times” on page 89. The 
attributes use the SMIL timing values described in 
“Specifying Timing” on page 88. 


Linking to a SMIL File 


A SMIL file can define a link to another SMIL file or another part of itself. For 
example, a video played through a SMIL file may link to another SMIL file so 
that when a viewer clicks the video, a new presentation starts up in RealPlayer. 
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To do this, you simply set the href attribute for the <a> or <anchor> tag to the 
new SMIL file’s URL. 


You can also link to portions of a SMIL file. The following example from a 
target SMIL file uses id attributes (such as those used in regions to create 
region names) to define a target name for a <par> tag that groups a video and a 
text clip. This id attribute functions like a name attribute in an HTML <a> tag: 
<par id="text_and_video”> 

<video src="video2.rm” region="newsregion”/> 

<textstream src="text.rt” region="textregion”/> 
</par> 


You then link the source SMIL file to the named target by including a pound 
sign (“#”) and the target name within the link URL. Assuming the target SMIL 
file is named newmedia.smil, the source file’s link to the <par> group looks like 
this: 
<a href="rtsp://realserver.example.com/newmedia.smil#text_and_video”> 

<video src="video.rm” region="videoregion”/> 
</a> 


Note that the target SMIL file defines two regions, newsregion and textregion. 
When RealPlayer receives the new SMIL file, it creates those regions as 
specified in the file’s header. 


Tips for Linking to a SMIL File 


Note the following when linking to another SMIL file: 


- You can link to any clip or <par> or <seq> group by defining an id attribute 
for the clip or group. Do not link to an element in a SMIL file header, 
however. Although you can link to a <switch> group, do not link to a clip 
or group within a <switch> group. 


- You cannot link to a clip in a <par> group and exclude the other clips in 
that group. All clips in the group will play in their designated regions. 


+ If additional clips follow the target clip in the SMIL file, those clips play 
when the target clip finishes playing. 


Tip 
If you want to link to a single clip but the SMIL file that 
refers to that clip lists other clips as well, link to the clip 
directly. Or create a new SMIL file that lists only the 
single target clip. 
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- To link to a target within the same SMIL file, simply set the href attribute 
value to the target id, such as <a href="#text_and_video”>. Be sure to 
include the pound sign before the id value. 


Linking with a Timeline Offset 


You can use the <anchor> tag’s time coordinates to create a timeline offset in a 
linked clip. Suppose you want to link a video to another video at 30 seconds 
into the second video’s timeline. In the source SMIL file, you define an <a> or 
<anchor> link from the first video to a SMIL file that contains the second 
video. In the second SMIL file, the video’s <anchor> tag defines the timeline 
offset using SMIL timing parameters. 


Here is a sample of the link in the first SMIL file: 


<a href="rtsp://realserver.example.com/newmedia.smil#vid2”> 
<video src="video.rm” region="videoregion”/> 
</a> 


The following is the linked video clip in the second SMIL file, newmedia.smil: 


<video src="video2.rm” region="newsregion”> 
<anchor id="vid2” begin="30s” /> 
</video> 


Additional Information 
“Specifying Timing” on page 88 describes the SMIL 
timing values. 





ef 


EXTENDING SMIL 
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Chapter 7 covers the basics of SMIL, the industry-standard language 
for streaming multimedia. This chapter describes RealNetworks’ 
SMIL extensions, which enhance SMIL’s playback ability. These 
extensions work only with RealSystem, not with any other SMIL- 
based media player. Use them only when streaming clips from 


RealServer to audiences using RealPlayer. 


Defining Image Options 
For a still image, you can use the following options to modify the image’s 
streaming characteristics, or to link it to RealPlayer commands. These options 
are not SMIL parameters, but extensions to the image’s SMIL source tag, 
which is described in “Specifying Clip Locations” on page 81. The following 
table summarizes the image options, which are described in detail below. 


Options for Image Source Tag 

















Option Function Format Values Example 

bitrate | Sets streaming bit all bits per second | bitrate=1000 
rate. 

bgcolor | Substitutes color for | GIF color name or | bgcolor=black 
transparency. hex value bgcolor=AA3344 

url Links to URL ora all URL or url=http://www.real.com 
RealPlayer command. command url=command:stop() 

target | Sets browser or all _browser target=_browser 
RealPlayer as target. _player target=_player 

reliable | Ensures image arrival. | all true reliable=true 

















A question mark operator (“?”) separates image options from the image URL 
in the SMIL source tag. To use multiple image options, put a question mark 
before the first option, then separate the remaining options with ampersands 
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(“&”). The order of options does not matter. The following shows the general 
form for two image options added to the image source tag. Note that image 
options and values are not in quotation marks because they are part of the 
quoted src value: 


<img src=“URL? option=value&option=value”/> 
Here is an example that combines bit rate and background color options: 


<img src="button.gif?bitrate=1000&bgcolor=blue”/> 


Setting Image Bit Rates 


By default, an image streams at 12 Kbps until RealPlayer receives it. You can 
set a higher bit rate to take advantage of bandwidth availability and stream an 
image quickly. Or you can set a lower bit rate when streaming images in 
parallel with another clip so that the other clip has enough bandwidth for 
uninterrupted playback. The following example shows three sequential image 
files set to stream at a low bit rate to ensure that a video playing in parallel 
does not stall: 
<par> 
<video src="video.rm” region ="videoregion” /> 
<par> 
<seq> 
<img src="ad1.gif?bitrate=1000” begin="30s” dur="60s” region="adregion”/> 
<img src="ad2.gif?bitrate=1000” dur="120s” region="adregion”/> 
<img src="ad3.gif?bitrate=1000” dur="60s” region="adregion” /> 
</seq> 
</par> 
</par> 


In this example, each GIF image is set to stream at 1 Kbps. This ensures that 
each image consumes a small amount of bandwidth and does not interfere 
with video playback. The <par> tag just outside the <seq> tag makes RealServer 
balance the bit rates of the images as a single group rather than as a discrete 


sequence. 


Additional Information 
For more on using <par> to balance bandwidth, see 
“Smoothing Transitions between Clips” on page 195. 


Keep in mind that the image size divided by the maximum bit rate equals the 
minimum time for streaming the image. Assuming images in this example are 
30 Kilobits, each image takes about 30 seconds to stream. For this reason, the 
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first image is set to display 30 seconds after the video begins to play. If no 
begin time were defined, the video would be delayed up to 30 seconds while 
the first image streams to RealPlayer. As well, each successive image must be 
able to stream during the preceding image’s duration. 


Overriding GIF Transparency 


For GIF images that include transparency, you can use bgcolor to substitute a 
color for the transparency. Color values are any hexadecimal color value 
without the leading pound sign (“#”), or a predefined color name as described 
in “Adding a Background Color” on page 103. If you do not set the color, the 
region’s defined background color shows through transparent spots in the 
image. Here is an example: 


<img src="button.gif? bgcolor=BB21AA” /> 


Linking to a Web Page or Clip 


The image url and target options let you link an image with a fully qualified 
URL. When the viewer clicks the image, the URL opens in the viewer’s browser 
or RealPlayer. The following example shows an image linked with a URL that 
opens in the viewer’s default browser: 


<img src="home.gif?url=http://www.example.com&target=_browser” region="home”/> 


The next example shows an image linked with a URL that opens in RealPlayer: 


<img src="go.gif?url=rtsp://realserver.example.com/media.smil&target=_player” 
region="next”/> 


Keep in mind that opening a URL in RealPlayer replaces the current 
presentation with the new clip or SMIL file. 


Note 
The image hyperlink options duplicate the SMIL 
hyperlink features described in “Linking to Other 
Media”, beginning on page 108. You can use either 
method depending on your preference. 


Controlling RealPlayer 


With url=command:command&target=_player, you can make the image a link that 
causes RealPlayer to stop, pause, play, or seek to a specific point in the 
presentation timeline. The following example shows three images set to 
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appear in three separate SMIL regions. Each image issues a different 
RealPlayer command when clicked: 
<par> 
<img src="play.gif?url=command:play()&target=_player” region="play”/> 
<img src="pause.gif?url=command:pause()&target=_player” region="pause”/> 
<img src="stop.gif?url=command:stop()&target=_player” region="stop”/> 
</par> 


n image can also issue a seek comman at specifies a certain point in the 
A ] k d that f t tin th 
presentation timeline: 


<img src="seek.gif?url=command:seek(1:35.4) &target=_player” 
region="seek” /> 


In the example above, clicking the image instructs RealPlayer to seek to 1:35.4 
into the presentation. This option does not use SMIL shorthand timing values 
such as s for seconds or min for minutes. Instead, the time format is like the 
“Normal Play Time Format” described on page 89, except that it also accepts 
milliseconds and days as possible values. 


dd:hh:mmi:ss.xyz 


Here, dd is days, hh is hours, mm is minutes, ss is seconds, x is tenths of 
seconds, y is hundredths of seconds, andz is milliseconds. Only the ss field is 
required. 


When the time value does not include a decimal point, the last field is read as 
the seconds. For example, 1:30 means 1 minute and 30 seconds, whereas 
1:30:00 means 1 hour and 30 minutes. Thus all the following values seek to 
the point in the timeline 90 minutes after the presentation begins: 
url=command:seek(1:30:00.0)&target=_player 


url=command:seek(90:00)&target=_player 
url=command:seek(5400)&target=_player 


Ensuring Reliable Image Transmission 


Use the reliable=true option to indicate that the image must be delivered to 
RealPlayer under any circumstance: 


<img src="button.gif?reliable=true”/> 
During extremely adverse network conditions, RealSystem will halt the 
presentation if necessary rather than drop the image. You should use this 


option sparingly, though, because RealSystem normally ensures that very little 
data loss occurs in transmission. 
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Popping Up New RealPlayer Windows 


Although RealPlayer G2 displays clips only in its main display window, 
RealPlayer 7 can open as many player windows as the computer CPU and 
memory allow. This lets you keep navigation information visible in one 
window, for example, while content plays in another window. New windows 
open when a viewer clicks a specially configured hyperlink within a SMIL or 
RealText file. 


Additional Information 
RealText Authoring Guide is available for download at 
http://service.real.com/help/library/index.html. For 
information on supporting both multiple windows with 
newer RealPlayers and a single window with RealPlayer 
G2, see “Switching Presentations for Different 
RealPlayer Versions” on page 201. 


Creating a Link for a New Window 


You open a new RealPlayer window through a hypertext link in a RealText or 
SMIL file. RealText and SMIL both support HTML-style hypertext links. 
Unlike HTML, though, RealSystem mark-up tags are case-sensitive. A 
RealSystem hyperlink that opens a new RealPlayer window uses this format: 


<a href=“command:openwindow(name, URL, playmode=value, ...)">...</a> 


When a viewer clicks a link with this syntax, command:openwindow tells 
RealPlayer to open a new window for the given URL, and stop the presentation 
in the current window. This command requires two arguments, name and URL. 
The playmode arguments are optional. You can separate arguments with a 
comma, but this is not required. A space may precede or follow a comma. If an 
argument contains characters such as commas or parentheses, enclose it in 
single quotation marks. 
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name 

The mandatory name argument comes first. It supplies a predefined or user- 
defined name for the new RealPlayer window. The following table gives the 
values for the name argument. 


name Argument 


Name Function 





_new or | Opens a new RealPlayer window each time the viewer clicks the link. Each 
_blank subsequent link named _new or _blank opens a new window as well. 





_self or | Opens the URL in the current RealPlayer window. 











_current 

name Creates a new RealPlayer window with the user-defined name. A 
subsequent openwindow command using the same name opens the given 
URL in the same window. 

URL 


Following the name argument, the required URL argument gives the fully 
qualified URL to the clip or SMIL presentation. You must include the 
protocol, such as rtsp://, http://, chttp://, or file:// in the URL. Relative URLs 
do not work. 


playmode 

The optional playmode=value argument defines the state of the new RealPlayer 
window that opens. A command to open a new window can have more than 
one playmode argument. The following table gives the possible values for 

















playmode. 
playmode Attributes and Values 
Attribute Value Function 
true Puts window in autosize mode so that it minimizes to just 
the display window when the cursor is not over it. 
autoize false Opens window in compact mode so that it does not change 
size on a mouseover. This is the default. Note that normal 
view mode is available only on the main RealPlayer window, 
not the pop-up windows. 
normal | Plays clip at its normal encoded size. This is the default. 
double | Doubles clip size. 
zoomlevel 
full Plays clip at full-screen. If the operating system does not 
support full-screen zoom, normal mode is used instead. 








(Table Page 1 of 2) 
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playmode Attributes and Values (continued) 





Attribute Value Function 
. true Keeps window on top of other windows on the desktop. 
ontopwhile : ; - = 
lavi false Lets user determine which windows to place on top. This is 
playing 
the default. 


(Table Page 2 of 2) 


Additional Information 
You can also open the initial presentation in double or 
full-size mode through a Ram file. For details on doing 
this, as well as guidelines on using double and full- 
screen modes, see “Changing a Presentation’s Starting 
Size” on page 167. 


Examples of Opening New RealPlayer Windows 


The following sections provide examples of how to create hyperlinks that 
launch new RealPlayer windows. The first three sections illustrate how to 
target various windows with the hyperlink syntax. They use RealText links as 
examples. The fourth example shows a hyperlinked image in SMIL. The last 
sample illustrates a SMIL hotspot link for a video clip. 


Targeting the Same Window with Multiple Links in RealText 


The following RealText link opens a URL in a new RealPlayer window named 
feature. The new window is set to autosize mode: 


<a href="command:openwindow(feature, rtsp://realserver.example.com/comedy.rm, 
autosize=true)”>Comedy Hour</a> 


When first clicked, this link creates a RealPlayer window named feature. If 
another link also targets the feature window, clicking that link starts the new 
URL in the feature window. Clicking the following link, for example, starts an 
animal program in the window running the comedy program. This link 
switches the window out of autosize mode, though: 


<a href="command:openwindow/(feature, rtsp://realserver.example.com/animals.rm, 
autosize=false)”>Sharks!</a> 


Opening Separate Windows with RealText 


Each link opens a separate window if the window names are different, or you 
use the predefined name _new or _blank. The following links open separate 
autosizing windows that play on top of all other desktop windows: 
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<a href="command:openwindow(_new, rtsp://realserver.example.com/comedy.rm, 
autosize=true, ontopwhileplaying=true)”>Comedy Hour</a> 


<a href="command:openwindow(_blank, rtsp://realserver.example.com/animals.rm, 
autosize=true, ontopwhileplaying=true)”>Sharks!</a> 


Launching URLs in the Current Window through RealText 


Use either _current or _self to open the URL in the current window: 

<a href="command:openwindow(_self, 

rtsp://realserver.example.com/comedy.rm, zoomlevel=double)”>Comedy Hour</a> 
The next link plays the clip at double its encoded size: 


<a href="command:openwindow(_current, 
rtsp://realserver.example.com/animals.rm)”>Sharks!</a> 


Linking from a SMIL File Image 


A SMIL file cannot display text on screen, so it does not support the text links 
described above for RealText. However, SMIL can make hyperlinks out of GIF, 
JPEG, and PNG images, or any other type of clip that displays on-screen. You 
can use an image file as a button, for example, that launches a new RealPlayer 
window. The following sample shows a hyperlinked image file within a SMIL 
file. The hyperlink syntax is the same as described above for RealText: 


<smil> 


<a href="command:openwindow(_new, rtsp://realserver.example.com/animals.rm)”> 
<img src="launch_button.gif” region="button”/> 
</a> 


</smil> 


Additional Information 
For basic information on SMIL hyperlinks, see “Linking 
to Other Media” on page 108. 


Creating a SMIL Hotspot Link 


SMIL lets you create hotspot links (image maps) over any clip. The following 
example defines a hotspot link over the upper, left-hand quadrant of a 
RealVideo file. Clicking this hotspot launches the hyperlink URL in a new 
RealPlayer window: 
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<smil> 


<video src="rtsp://realserver.example.com/video/videol.rm” region="video”> 
<anchor href=“command:openwindow(_new, 
rtsp://realserver.example.com/video/video2.rm)” coords="0,0,25%,25%" /> 
</video> 


</smil> 


Additional Information 
See “Defining Hot Spot Links” on page 110 for the 
basics of creating hot spots. 


Caching Images Files 


RealPlayer 7 can cache on disk any files delivered through HTTP. You may 
want to cache GIF, JPEG, or PNG images that are part of a SMIL presentation, 
for example. Caching images is beneficial when viewers reload or revisit 
presentations frequently. An example is an Internet radio station that uses 
GIF logos and on-screen buttons. As long as the GIFs reside in the RealPlayer 
cache, the server does not have to resend the files if, for example, the user 
clicks a link that opens a new SMIL presentation containing the same images. 


Caching works only for files delivered through HTTP. You should not try to 
cache clips best served through RTSP, including video, audio, RealText, Flash, 
and RealPix clips. (RealPlayer caches RealPix images in memory, but not on 
disk, for the duration of the RealPix presentation.) Nor should you cache ads 
or images that do not appear consistently in your presentation. 


RealPlayer 7 caches files within the RealPlayer home directory in a folder 
named cache_db. Its cache is independent of any Web browser cache. The 
default RealPlayer cache size is 4 MB, though the user can change the size. The 
cache is limited because it is meant to hold small images such as buttons and 
logos, not large graphics or streaming clips. 


Note 
Caching does not work with RealPlayer G2. For 
information on using caching with newer RealPlayers 
while supporting RealPlayer G2, see “Switching 
Presentations for Different RealPlayer Versions” on page 
201. 
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Using the “CHTTP” Caching Protocol 


RealPlayer 7 does not cache all items streamed by HTTP. Instead, you 
designate files to cache by using chttp:// instead of http:// in the file’s URL. 
When RealPlayer reads a CHTTP URL in a SMIL file, it first checks its disk 
cache for the file. If the file isn’t present, it requests the file through HTTP, 
storing the file in its cache. Because RealPlayer interprets a chttp:// URL asa 
special instance of HTTP downloading, caching works for any file stored on 
an HTTP-compatible server. 


If a file is stored in its cache, RealPlayer reuses it instead of requesting it again 
from the server as long as a CHTTP URL is used. The cached version is not 
used, though, if the URL starts with http:// or differs in any way from the 
original CHTTP URL. As well, any new file requested through RTSP, HTTP, or 
PNA is not cached. The following SMIL example indicates that the GIF image 
should be initially downloaded, then cached for later use: 


<img src="chttp://www.example.com/images/imagel.gif” region="image”/> 


This URL causes RealPlayer to store image1.gif in the cache for later use until 
the cached file has expired or is overwritten. “Cache Size and Expiration 
Rules” on page 127 describes the cache expiration rules. 


Controlling the RealPlayer 7 Cache 


RealPlayer supports the same HTTP header fields used to control file 
expiration in Web browser caches. It can thereby carry out caching directives 
set by Web servers. This lets you reuse Web page images in RealPlayer 
presentations without losing control of how these images are cached. The 
following sections describe how to use HTTP headers to control the RealPlayer 
cache, and how RealPlayer manages its cache. Documentation for most Web 
servers includes information about how to set fields in HTTP header files. 


Overriding Caching with Cache-Control 


The Cache-Control command of an HTTP header file can override caching of a 
RealPlayer file requested through chttp://. A file requested through CHTTP is 
not cached if any of the following are present as meta-information in the 
HTTP header file: 

¢ Cache-Control:no-cache 

¢ Cache-Control:no-store 


* Cache-Control: private 
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* Cache-Control:must-revalidate 


Cache Size and Expiration Rules 


By default, RealPlayer’s HTTP cache size is set to 4 MB, although users can 
modify this size. Unless an HTTP header sets a file lifetime, the cached file 
expires after 4 hours. A subsequent request for a cached item restarts the 
item’s expiration clock. When the cache fills, RealPlayer begins to delete 
unexpired items to reclaim needed disk space on a first in, first out basis. 


Changing the Lifetime of a Cached File 


Within an HTTP header, Cache-Control:max-age can set the “time to live” (TTL) 
for a cached file, overriding the default expiration time. Specified as seconds, 
the maximum age is added to the current time to get the file’s expiration time. 
This value must be between 60 seconds and one year. For example: 


Cache-Control:max-age=172800 
If the Cache-Control:max-age field is not used, an Expires field can determine 
expiration time. The Expires field takes as an attribute a date string that 


defines when the cached element expires, relative to the caching computer’s 
clock. The date string is formatted as: 


Expires= Wdy, DD Mon YYYY HH:MM:SS GMT 


The weekday is optional. Here are two examples, the first with the weekday 
designation and the second without: 


Expires= Fri, 17 Mar 2000 19:37:09 GMT 
Expires= 17 Mar 2000 19:37:09 GMT 
The weekday and month abbreviations are the following: 


day of week: Mon, Tue, Wed, Thu, Fri, Sat, Sun 
month: Jan, Feb, Mar, Apr, May, Jun, Jul, Aug, Sep, Oct, Nov, Dec 


Note 
The entry is not cached if the value of the Expires: field is 
earlier than the current date and time. 


User Control of the RealPlayer 7 Cache 


RealPlayer users can control some aspects of RealPlayer’s cache by disabling 
the cache, setting the disk space available for the cache, and emptying the 
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cache. Users perform these functions through the RealPlayer preferences. For 
more information, see the RealPlayer 7 online help. 


Authoring SMIL Files for Caching 


To cache files, write your SMIL file to download the cached items before other 
streamed elements. You can do this by placing the cached elements in a SMIL 
<seq> group ahead of the streamed elements. The following SMIL extract, 
which omits the header information for convenience, caches two logo images. 
The SMIL file is for a presentation in which logos stay the same, but the 
streaming RealVideo and RealText clips change frequently: 


<smil> 
...header omitted from example... 
<body> 
<seq> 
<!-- First, download and cache these two logos. --> 
<img src="chttp://www.example.com/images/logol.gif?bitrate=20000” 
region="logo1” fill="freeze”/> 
<img src="chttp://www.example.com/images/logo2.gif?bitrate=20000” 
region="logo2” fill="freeze”/> 
<par> 
<!--Second, stream these 2 clips in parallel. --> 
<textstream src="rtsp://realserver.example.com/news.rt” 
region="newsregion” fill="freeze”/> 
<video src="rtsp://realserver.example.com/newsvid.rm” 
region="videoregion”/> 
</par> 
</seq> 
</body> 
</smil> 


In this example, the two logos quickly download in sequence. Next, RealServer 
streams a parallel group comprising the RealVideo and RealText clips. When 
RealPlayer plays this presentation again, it first checks its cache for the two 
logos. If it finds them, it skips directly to the streaming clips. 
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PLAYING CLIPS IN A WEB PAGE : J 
Embedding a presentation in a Web page provides seamless playback 
without launching RealPlayer as a separate application. You can 
even include RealPlayer controls such as fast forward and pause. 
This chapter explains how you add mark-up to a Web page so that 


people view your RealSystem presentation directly through their 


Web browsers. 


Additional Information 
Refer to this chapter for full information on embedding 
a presentation. For a quick example of how to embed a 
video in a Web page, see “Embedding a RealVideo Clip 
in a Web Page” on page 191. 


Choosing the Netscape Plug-in or ActiveX Control 


To provide Web page playback, RealPlayer includes a plug-in for browsers that 
support the Netscape plug-in architecture: 


+ Netscape Navigator 3.0, 4.0, and higher. 
+ Microsoft Internet Explorer 3.0 and 4.0. 


It also has an ActiveX control that provides playback capabilities within these 
products: 


+ Microsoft Internet Explorer 3.0 and 4.0. 


- Any application that supports ActiveX controls, such as Visual Basic, 
Visual C++, Microsoft Access, and so on. 


Because they both have the same capabilities, you can use either the plug-in or 
the ActiveX control depending on which products you need to support. The 
following sections describe the basics of using the plug-in or the control, then 
explain each parameter you can set. 
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Note 
Familiarity with RealPlayer and HTML will make it 
easier to use the plug-in or control. In the examples 
below, ellipses (...) indicate information left out to keep 
the examples short. Make sure your tags include all 


necessary information. 


Additional Information 
Embedded RealPlayer Extended Functionality Guide at 
http://service.real.com/help/library/index.html 
explains how to use JavaScript or VBScript to extend the 
functionality of the Netscape Plug-in or ActiveX control. 


Using <EMBED> Tags for the Netscape Plug-In 


To use RealPlayer’s Netscape plug-in, you add <EMBED> tags to your Web page 
HTML. Each <EMBED> tag has three required parameters (SRC, WIDTH, HEIGHT), 
and can include many optional parameters. The basic <EMBED> tag looks like 
the following (the SRC value, which is explained below, has been omitted for 
simplicity): 

<EMBED SRC="...” WIDTH=300 HEIGHT=134> 


This tag creates a playback area 300 pixels wide by 134 pixels high within the 
Web page. Parameters typically have the form PARAMETER=value. The parameter 
names can be any case, though this manual shows them uppercase. Except for 
file names, which must typically be lowercase, parameter values are not case- 
sensitive. Unless they are URLs, parameter values do not need to be inside 
quotation marks. 


Supporting Other Browsers 


To accommodate browsers that do not support the Netscape plug-in, use 
<NOEMBED> to define a standard hypertext link to your presentation. The 
unembedded link follows the <EMBED> tag: 


<EMBED SRC="...” WIDTH=300 HEIGHT=134> 
<NOEMBED><A HREF="...”>Play with RealPlayer.</A></NOEMBED> 


In this example, browsers that can play the embedded presentation hide the 
text between <NOEMBED> and </NOEMBED>. Other browsers ignore the preceding 
<EMBED> tag and display just the hypertext link. The user then clicks the link 
to play the presentation in RealPlayer. 





130 


RealSystem G2 Production Guide CHAPTER 9: Playing Clips in a Web Page 





Using <OBJECT> Tags for the ActiveX Control 


You embed the RealPlayer ActiveX control in HTML pages with the <OBJECT> 
tag. This tag uses an ID that you select, such as ID=RVOCX, and must have the 
following class ID that identifies RealPlayer: 


CLASSID="clsid: CFCDAA03-8BE4-11cf-B84B-0020AFBBCCFA” 


The <OBJECT> tag also sets the width and height of the playback area within 
the browser. A typical <OBJECT> tag looks like this: 

<OBJECT ID=RVOCX CLASSID="clsid: CFCDAA03-8BE4-11cf-B84B-0020AFBBCCFA” 
WIDTH=300 HEIGHT=134> 


... parameters ... 
</OBJECT> 


This tag creates a playback area 300 pixels wide by 134 pixels high within the 
Web page. Between <OBJECT> and </OBJECT>, you can define any number of 
additional parameters in this form: 


<PARAM NAME="name” VALUE="value”> 


PARAM, NAME, and VALUE markers can be any case, though this manual shows 
them uppercase. Parameter values are not case-sensitive except for file names, 
which must typically be lowercase. Always enclose parameter values in double 
quotation marks. 


Setting Basic Parameters 


SRC 


Both the Netscape plug-in and ActiveX control use the same basic tag 
parameters. As explained above, the tag syntax for the plug-in and the control 
differs, however. The following sections explain the basic parameters you can 
include in each <EMBED> or <OBJECT> tag. 


The SRC parameter gives the presentation’s source URL surrounded by double 
quotes. The directory names cannot contain spaces. For the ActiveX control, 
the <OBJECT> tag’s CLASSID parameter causes the presentation to play back in 
the Web page, so you can simply link to the SMIL file or clip within one 
<OBJECT> tag. When linking to a presentation on RealServer, the URL can use 
Ramgen, but this is not necessary: 


<PARAM NAME="SRC” VALUE="http://realserver.example.com:8080/ramgen/sample.smil”> 
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When you use the Netscape plug-in, you need to include the SRC parameter in 
every <EMBED> tag. You can specify two types of URLs. The first uses the 
?embed option to RealServer’s Ramgen, which causes RealPlayer to play the 
clip or SMIL presentation through its Netscape plug-in instead of launching 


as a separate application: 


SRC="http://realserver.example.com:8080/ramgen/sample.smil?embed” 


Additional Information 
For more on Ramgen and presentation URLs, see 
“Linking your Web Page to RealServer” on page 159. 


The second option is to create a Ram file with a .rpm extension and list this 
file in the SRC parameter without including Ramgen and the ?embed option. 
The Ram file then links to your SMIL file or clips. The following example 
links to a .rpm file on a Web server: 


SRC="http://www.example.com/media/sample.rpm” 


Additional Information 
For instructions on writing a .rpm file, see “Creating a 
Ram File Manually” on page 165. 


You must create and link to a .rpm file in any of the following situations: 
- Your RealServer does not use Ramgen. 
+ The SMIL file or clip is on a Web server. 


- All files are located on a user’s local computer rather than streamed over a 
network. 


Note 
When linking to local files, you can use relative links 
just like in HTML. You can also use absolute links. 
When using absolute links with the Netscape plug-in, 
use forward slashes in paths. For example, instead of 
file://c:\media\first.rpm, set the source as 
file://c:/media/first.rpm. 


WIDTH and HEIGHT 


Required for each <EMBED> or <OBJECT> tag, the WIDTH and HEIGHT parameters 
set the size of the playback area. If you leave them out, the playback area may 
appear as a tiny icon because streaming media presentations do not size 
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automatically. The values for WIDTH and HEIGHT are in pixels by default, so a 
width of 300 creates a playback area 300 pixels wide. Setting WIDTH and HEIGHT 
to 0 (zero) hides the playback area. 


You can also express WIDTH and HEIGHT as percentages of the browser window 
size. For example, a width of 50% makes the presentation area half the browser 
width. Keep in mind that different types of media scale with different results. 
A video scaled larger than its encoded size may not look good. Vector-based 
media such as Flash animation scale more easily to fit different playback areas, 
however. 


NOJAVA 


Setting NOJAVA to true in every <EMBED> tag prevents the browser’s Java Virtual 
Machine (JVM) from starting if it is not yet running: 


<EMBED SRC=”...” WIDTH=300 HEIGHT=134 NOJAVA=true> 


This is recommended when using the Netscape plug-in because the JVM is not 
required for the <EMBED> parameters described in this chapter. Starting the 
JVM therefore delays presentation playback unnecessarily. The JVM is required 
only when extending plug-in functionality with JavaScript. In this case, omit 
NOJAVA entirely from the <EMBED> tags. 


Additional Information 
See Embedded RealPlayer Extended Functionality Guide at 
http://service.real.com/help/library/index.html for 
more information on controlling RealPlayer with 
JavaScript. 


Note 
Although you can include NOJAVA as an ActiveX 
parameter, it has no effect on Internet Explorer, which 
launches its JVM on browser start-up. 


Adding RealPlayer Controls 


With the CONTROLS parameter, you can place RealPlayer controls such as a 
play/pause button in your Web page. A visitor to your page can then control 
the presentation playback just as if using RealPlayer as a separate application. 
The following example for the Netscape <EMBED> tag displays the play/pause 
button: 
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<EMBED SRC=”...” WIDTH=26 HEIGHT=26 NOJAVA=true CONTROLS=PlayButton> 


For the ActiveX control, you define a CONTROLS parameter within the <OBJECT> 
tag structure: 

<OBJECT ID=RVOCX CLASSID="...” WIDTH=26 HEIGHT=26> 

<PARAM NAME="SRC” VALUE=”"...”> 

<PARAM NAME="CONTROLS” VALUE="PlayButton”> 

</OBJECT> 


The following sections describe each RealPlayer control you can use. A tag’s 
WIDTH and HEIGHT parameters set the control’s size. The suggested pixel widths 
and heights given below produce embedded controls approximately the same 
sizes as the RealPlayer controls. Specifying different pixel sizes scales the 
controls larger or smaller. You can also use percentage values for sizes, but this 
is recommended only for the image window. 


Additional Information 
For information on adding more than one control to 
your Web page, see “Linking Multiple Controls” on page 
139. 


Tip 
Download the HTML version of this manual from 


http://service.real.com/help/library/index.html to 
see online examples of embedded RealPlayer controls. 


Basic Controls 


ImageWindow 


BEL arin 
Cael Sees 


Displays the image window. This is available only for display presentations 
such as video or animation. Even if no other controls are visible on the page, 
the user can typically right-click (on Windows) or hold down the mouse 
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All 


button (Macintosh) on the playback area to display a menu of choices such as 
Play and Stop. See also “Controlling Image Display” on page 142. 


Suggested pixel width: 176 or higher 
Suggested pixel height: 132 or higher 


rn iy: > ¥& real) 





Clip Info: [Embedded RealPlayer Demonstration 4] a | 


Displays the basic RealPlayer control panel. The control name “default” also 
works. Buttons include play, pause, stop, fast forward, and rewind. Sliders 
include a position slider and a volume slider with mute button that pops up 





when the speaker button is clicked. Below the buttons are a clip information 
field, a status panel, a network congestion indicator, and a clip timing field. 


Suggested pixel width: 375 
Suggested pixel height: 100 


Individual Controls and Sliders 


ControlPanel 


>i «ey. lD>rDdUY 





Displays the play, pause, stop, fast forward and rewind buttons. There’s also a 
position slider, along with a volume slider and mute button that pops up 
when the speaker button is clicked. 

Suggested pixel width: 350 

Suggested pixel height: 36 
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PlayButton 


ari Displays a play/pause button. 


Suggested pixel width: 44 
Suggested pixel height: 26 


PlayOnlyButton 


Displays a play button. 
&| 


Suggested pixel width: 26 
Suggested pixel height: 26 


PauseButton 
rt | 


Displays a pause button. 


Suggested pixel width: 26 
Suggested pixel height: 26 


StopButton 


Displays a stop button. 
| Suggested pixel width: 26 


Suggested pixel height: 26 


FFCtrl 


Displays a fast forward control. 
> | 


Suggested pixel width: 26 
Suggested pixel height: 26 


RWCtrl 


Displays a rewind control. 
4 | 

Suggested pixel width: 26 

Suggested pixel height: 26 
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MuteCtrl 


Displays a mute button. 
| Suggested pixel width: 26 
Suggested pixel height: 26 


MuteVolume 
Displays a mute button and volume slider. 


Suggested pixel width: 26 





Suggested pixel height: 88 
ut 
VolumeSlider 


Displays a volume slider. 


Suggested pixel width: 26 





Suggested pixel height: 65 


PositionSlider 


| 


Displays a clip position slider. 


Suggested pixel width: 120 
Suggested pixel height: 26 


TACCtrl 


Clip Info: [Embedded RealPlayer Demonstration 4] 6 | 


Displays a clip information field. For instructions on formatting the clip 
playlist, see “Managing the Playlist” on page 96. 


Suggested pixel width: 370 
Suggested pixel height: 32 
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HomeCtrl 


— 


Displays the Real™ logo. 


Suggested pixel width: 45 
Suggested pixel height: 25 


Information Panels 


InfoVolumePanel 


Embedded RealPlayer Demonstration 
RealNetworks, Inc 


21998 





Displays presentation information along with the volume slider and mute 
button. For more on presentation information, see “Adding Presentation 
Information” on page 95. See also “NOLABELS” on page 143. 


Suggested pixel width: 325 
Suggested pixel height: 55 


InfoPanel 


Embedded RealPlayer Demonstratior 


Networks, Inc 








Displays the presentation information panel. For more on presentation 


information, see “Adding Presentation Information” on page 95. See also 
“NOLABELS” on page 143. 


Suggested pixel width: 300 
Suggested pixel height: 55 


Status Panels 


StatusBar 
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Displays the status panel, which shows informational messages. It also 
includes the network congestion LED and the position field, which shows 
current place in the presentation timeline along with total clip length. 


Suggested pixel width: 300 
Suggested pixel height: 30 


Note 
The status bar is included in the All control. If you do 
not embed a status bar or status field in your page, error 
messages display in the browser’s status bar. 


StatusField 





Displays the message text area of the status bar. If you do not embed a status 
field or status bar in your page, error messages display in the browser’s status 


bar. 
Suggested pixel width: 200 
Suggested pixel height: 30 


PositionField 


ona 6von05 3) 


Displays the position field, which shows the clip’s current place in the 
presentation timeline and the total clip length. 


Suggested pixel width: 90 
Suggested pixel height: 30 


Linking Multiple Controls 


The CONSOLE parameter defines a name that unifies <EMBED> or <OBJECT> tags 
so that multiple controls work together. For example, you could create three 
separate <EMBED> or <OBJECT> tags to define an image window, a play button, 
and a stop button. By using three tags, you can set the size of each control 
separately and define its layout with HTML tags. You could put each control 
in a different HTML table cell, for example. 
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To tie controls together, define the same CONSOLE name within each <EMBED> 
or <OBJECT> tag, or use one of these predefined names: 


_master links the control to all other embedded controls on the page. 
_unique links the control to no other embedded controls on the page. 


You can have multiple console names for separate presentations. For a page 
showing two video clips, for example, you can define console names of video1 
and video2. All controls linked by video1 interoperate and all controls linked by 
video2 interoperate. But a video1 volume slider, for example, will not affect the 
volume of a video?2 clip. 


Tips for Using Consoles 
Note the following when grouping multiple controls with CONSOLE attributes: 


- Every <EMBED> tag must have a SRC attribute. Tags linked by a console 
name should have the same SRC value. 


- With the ActiveX control, only one <OBJECT> tag in a console group needs 
to have a SRC value. 


- If the <EMBED> or <OBJECT> tags in a console group have different SRC 
values, the first valid source that RealPlayer finds among those choices 
becomes the console source. This may not always be the first source listed. 


+ Clicking a play button for one console stops playback for other consoles. 
This allows multiple consoles to play separate audio tracks or to use the 
same image window. 


Multiple Controls Example 


The following examples for the <EMBED> and <OBJECT> tags set up an image 
window and two sets of controls (a play button and stop button) for separate 
videos, sample1.rm and sample2.rm. The predefined console name _master links 
the image window to both control sets. The control sets use different console 
names, however, so they do not link to each other. Clicking each play button 
therefore starts a different video. 


Netscape Plug-in Sample Mark-up 

Because each <EMBED> tag must have a SRC value, the image window in the 
following example simply uses the same source as the first play button. The 
viewer simply clicks either play button to start a video. Clicking the other play 
button stops the first video and plays the second video. 
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<EMBED SRC="http://realserver.example.com:8080/ramgen/sample1.rm?embed” 
WIDTH=176 HEIGHT=128 NOJAVA=true CONTROLS=ImageWindow CONSOLE=_master> 


<H4>Video 1</H4> 

<EMBED SRC="http://realserver.example.com:8080/ramgen/sample1.rm?embed” 
WIDTH=44 HEIGHT=26 NOJAVA=true CONTROLS=PlayButton CONSOLE=video1> 
<EMBED SRC="http://realserver.example.com:8080/ramgen/sample1.rm?embed” 
WIDTH=26 HEIGHT=26 NOJAVA=true CONTROLS=StopButton CONSOLE=video1> 


<H4>Video 2</H4> 

<EMBED SRC="http://realserver.example.com:8080/ramgen/sample2.rm?embed” 
WIDTH=44 HEIGHT=26 NOJAVA=true CONTROLS=PlayButton CONSOLE=video2> 
<EMBED SRC="http://realserver.example.com:8080/ramgen/sample2.rm?embed” 
WIDTH=26 HEIGHT=26 NOJAVA=true CONTROLS=StopButton CONSOLE=video2> 


ActiveX Control Sample Mark-up 
In the following ActiveX example, only the controls for the two play buttons 
define the source URLs. For convenience the CLASSID value is omitted. 


<OBJECT ID=RVOCX CLASSID="...” WIDTH=176 HEIGHT=128> 
<PARAM NAME="CONTROLS” VALUE="ImageWindow’> 
<PARAM NAME="CONSOLE” VALUE="_master”> 
</OBJECT> 


<H4>Video 1</H4> 
<OBJECT ID=RVOCX CLASSID="...” WIDTH=44 HEIGHT=26> 
<PARAM NAME="SRC” 
VALUE="http://realserver.example.com:8080/ramgen/sample1.rm”> 
<PARAM NAME="CONTROLS” VALUE=" PlayButton”’> 
<PARAM NAME="CONSOLE” VALUE="video1”> 
</OBJECT> 
<OBJECT ID=RVOCX CLASSID="...” WIDTH=26 HEIGHT=26> 
<PARAM NAME="CONTROLS” VALUE="StopButton”> 
<PARAM NAME="CONSOLE” VALUE="video1”> 
</OBJECT> 


<H4>Video 2</H4> 
<OBJECT ID=RVOCX CLASSID="...” WIDTH=44 HEIGHT=26> 
<PARAM NAME="SRC” 
VALUE="http://realserver.example.com:8080/ramgen/sample2.rm”> 
<PARAM NAME="CONTROLS” VALUE=" PlayButton”’> 
<PARAM NAME="CONSOLE” VALUE="video2”> 
</OBJECT> 
<OBJECT ID=RVOCX CLASSID="...” WIDTH=26 HEIGHT=26> 
<PARAM NAME="CONTROLS” VALUE="StopButton”> 
<PARAM NAME="CONSOLE” VALUE="video2”> 
</OBJECT> 
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Controlling Image Display 


The following <EMBED> and <OBJECT> parameters control aspects of how clips 
play back. 


BACKGROUNDCOLOR 


This parameter specifies a background color for the image window. The 
specified background color also shows through if a clip includes transparency. 
The background color is black by default. You can use an RGB hexadecimal 
color value (#RRGGBB) or the following color names, shown here with their 
corresponding RGB values: 


white (#FFFFFF) silver (HCOCOCO) gray (#808080) black (#000000) 
yellow (#FFFFOO) fuchsia (#FFOOFF) red (#FFO000) maroon (#800000) 
lime (#00FFOO) olive (#808000) green (#008000) purple (#800080) 
aqua (#OOFFFF) teal (#008080) blue (HOOOOFF) navy (#000080) 


Note 
SMIL region background colors override this 
background color. For more on setting SMIL region 
colors, see “Adding a Background Color” on page 103. 


CENTER 


The default value for CENTER is false, which causes the clip to fill the entire 
playback area. If you set CENTER to true, the clip is centered within the playback 
area and displays at its encoded size. So by setting CENTER to true, you can 
create a large playback area with WIDTH and HEIGHT and still have the clip play 
at its normal size. You cannot use CENTER along with MAINTAINASPECT. 


MAINTAINASPECT 


This parameter, which you cannot combine with CENTER, determines whether 
the clip’s height-to-width ratio stays constant when the clip scales to fit the 
image window. The default value of false causes this ratio to change as 
necessary to fill the image window fully. This may distort the source image. 


If you set MAINTAINASPECT to true, a clip’s height-to-width ratio stays constant. 
For example, a clip’s height-to-width ratio of 1:1 stays constant even if the 
image window’s height-to-width ratio is 2:3. In these cases, the clip is centered 
in the image window and scaled until one dimension reaches the window’s 
boundaries and the other dimension is within the boundaries. The following 
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figure shows how clips scale by default, with MAINTAINASPECT set to true, and 
with CENTER set to true. 


Clip Scaling with MAINTAINASPECT and CENTER 


aida 


Source Clip Default Clip MAINTAINASPECT CENTER 
“true” “true” 





NOLABELS 


When you use a control that includes presentation information such as title, 

author, and copyright, you can include the NOLABELS option to suppress that 

information in RealPlayer 5.0. This option has no effect on RealPlayer G2 or 
higher. Here is an example for the Netscape plug-in: 


<EMBED ... CONTROLS=ALL NOLABELS=true> 


and an example for the ActiveX control: 


<OBJECT ...> 

<PARAM NAME="CONTROLS” VALUE="ALL"> 
<PARAM NAME="NOLABELS” VALUE="true”> 
</OBJECT> 


Additional Information 
“Parameter Reference” on page 148 lists the options that 
work with RealPlayer 5.0. 


NOLOGO 


When set to true, NOLOGO prevents the Real logo from displaying in the image 
window. When no clip is playing, only the specified background color shows 
in the window. The parameter is false by default. 


Setting Automatic Playback 


The AUTOSTART, LOOP, and NUMLOOP parameters let you set the content to start 
playing automatically, as well as loop continuously for a specified number of 
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times. The following example shows two of these parameters used with the 
Netscape plug-in: 

<EMBED SRC=”...” WIDTH=50% HEIGHT=50% NOJAVA=true AUTOSTART=true 
LOOP=true> 


Here is an example for the ActiveX control: 


<OBJECT ID=RVOCX CLASSID="...” WIDTH=50% HEIGHT=50%> 
<PARAM NAME="SRC” VALUE=”...”> 

<PARAM NAME="AUTOSTART” VALUE="true”> 

<PARAM NAME="LOOP” VALUE="true”> 

</OBJECT> 


AUTOSTART 


When set to true, the AUTOSTART parameter starts playback immediately. When 
you have multiple <EMBED> or <OBJECT> tags linked by a CONSOLE name, set 
AUTOSTART to true in just one tag. Leaving AUTOSTART out or setting its value to 
false means the presentation does not start until the user starts it, for 
example, by clicking an embedded play button. 


LOOP 


If the LOOP parameter is set to true, the presentation continuously loops until 
the viewer stops it. When you have multiple <EMBED> or <OBJECT> tags linked 

by a CONSOLE name, set looping in just one tag. If you leave the LOOP parameter 
out, the default value of false applies and the presentation stops after the first 
playback. The user can play the presentation again by clicking the play button. 


NUMLOOP 


If you specify a NUMLOOP value such as “2”, the presentation loops the specified 
number of times and then stops. If both LOOP and NUMLOOP are used, the LOOP 
parameter is ignored. 


SHUFFLE 


The SHUFFLE parameter is for use only with Ram or SMIL files that list a single 
sequence of clips. When set to true, SHUFFLE makes RealPlayer play back the 
clips in a random order. 
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Laying out SMIL Presentations 


As “Laying Out Multiple Clips” on page 99 explains, you can use a SMIL file to 
define separate playback regions for different parts of a presentation. This lets 
you lay out two clips side-by-side, for example. When playing a presentation in 
a Web page, you can define the layout in SMIL or in HTML. 


Defining the Layout with SMIL 


To control the layout through SMIL, you set up the regions and their relative 
placements in the SMIL file. You then use the Netscape plug-in or ActiveX 
control to create a playback region in the Web page large enough to 
accommodate all regions. This SMIL file then produces the same layout when 
played through the Web page or RealPlayer. 


The sample layout shown in “SMIL Layout Example” on page 107 defines 
three regions, creating a total playback area 430 pixels wide by 165 pixels high. 
To accommodate this in your Web page, you define an image window at least 
as large as this through the <EMBED> or <OBJECT> tag. Here are examples for the 
Netscape plug-in: 

<EMBED SRC=”...” WIDTH=430 HEIGHT=165 NOJAVA=true CONTROLS=ImageWindow 
CONSOLE=one> 


and ActiveX control: 

<OBJECT ID=RVOCX CLASSID="...” WIDTH=430 HEIGHT=165> 
<PARAM NAME="SRC” VALUE=”"...”> 

<PARAM NAME="CONTROLS” VALUE="ImageWindow”> 
<PARAM NAME="CONSOLE” VALUE="one”> 

</OBJECT> 


The SRC parameter provides the URL to the SMIL file. You can then use 
additional <EMBED> or <OBJECT> tags linked to the “one” console to provide 
RealPlayer controls for the presentation. 


Defining the Layout with HTML 


The second method omits SMIL layout information and defines the layout 
through HTML. You could place an image window and separate RealPlayer 
controls in an HTML table, for example. Each <EMBED> or <OBJECT> tags then 
uses a REGION parameter to define a region name. Clip source tags within the 
SMIL file list which region each clip plays in. For example, the SMIL file 
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shown in “SMIL Layout Example” on page 107 lists the following RealText file, 
set to play in the newsregion region: 


<textstream src="news.rt” region="newsregion”/> 


Within the HTML page, the <EMBED> tag that plays news.rt would look like 
this: 


<EMBED SRC="http://realserver.example.com:8080/ramgen/sample.smil?embed” 
WIDTH=250 HEIGHT=144 NOJAVA=true CONTROLS=ImageWindow 
REGION=newsregion CONSOLE=one> 


The <OBJECT> tag would look like this: 


<OBJECT ID=RVOCX CLASSID=”"...” WIDTH=250 HEIGHT=144> 

<PARAM NAME="SRC” 
VALUE="http://realserver.example.com:8080/ramgen/sample.smil”> 

<PARAM NAME="CONTROLS” VALUE="ImageWindow”> 

<PARAM NAME="REGION” VALUE="newsregion”> 

<PARAM NAME="CONSOLE” VALUE="one”> 

</OBJECT> 


You define similar <EMBED> or <OBJECT> tags to create other regions for other 
clips listed in the SMIL file. The SRC parameter in each tag lists the same SMIL 
file. You can also use additional <EMBED> or <OBJECT> tags linked to the same 
console to provide RealPlayer controls for the presentation. 


Omitting SMIL Layout Information 


When you define the presentation layout through HTML, you must omit the 
<layout> section from the SMIL file header. For example, the SMIL file shown 
in “SMIL Layout Example” on page 107 would not have a <layout> section: 


<smil> 
<head> 
<!--presentation with 2 text clips and 1 video clip--> 
<meta name="title” content="Music of the Week”/> 
</head> 
<body> 
<par> 
<!-- play these 3 clips simultaneously --> 
<textstream src="news.rt” region="newsregion” /> 
<video src="newsvid.rm” region="videoregion” /> 
<textstream src="stocks.rt” region="stockregion” /> 
</par> 
</body> 
</smil> 





146 


RealSystem G2 Production Guide CHAPTER 9: Playing Clips in a Web Page 





Tip 
A SMIL file without a layout still works with RealPlayer, 
but RealPlayer automatically creates the layout, and the 
results may not be what you expect. Always include a 
SMIL layout when playing a presentation directly in 
RealPlayer. 


Note 
Because there is no SMIL layout, hot spot links are 
ignored. You can make media clips hyperlinks with the 
SMIL <a>...</a> tags, however. For more on SMIL 
hyperlinks, see “Linking to Other Media” on page 108. 
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Parameter Reference 


The following table lists the <EMBED> and <OBJECT> tag parameters. Parameters compatible 
with RealPlayer 5.0 are indicated in the “5.0?” column. To have an embedded presentation play 
back with RealPlayer 5.0 as well as RealPlayer G2 or higher, use only 5.0-compatible 


















































parameters. 
<EMBED> and <OBJECT> Tag Parameter s 
Parameter Function 5.0? Values Default Reference 
AUTOSTART Sets automatic playback. yes | true|false false page 144 
BACKGROUNDCOLOR | Sets background color. no | color name or RGB | black page 142 
hex value 
CENTER Centers clip in window. no |true|false false page 142 
CONSOLE Links multiple controls. yes |name,_master,or |(none) | page 139 
_unique 
CONTROLS Adds RealPlayer controls. yes | control name All page 133 
HEIGHT Sets window or control height. | yes | percentage or pixels | (none) | page 132 
LOOP Loops clips indefinitely. no | true|false false page 144 
MAINTAINASPECT Preserves image aspect ratio. no |true|false false page 142 
NOJAVA Prevents JVM start-up. no | true|false false page 133 
NOLABELS Suppresses presentation yes | true|false false page 143 
information in RealPlayer 5.0. 
NOLOGO Suppresses RealLogo. no | true|false false page 143 
NUMLOOP Loops clip a given number of no | any number (none) | page 144 
times. 

REGION Ties clip to SMIL region. no | SMIL region (none) | page 145 
SHUFFLE Randomizes playback. no | true|false false page 144 
SRC Specifies source clip. yes | URL (none) | page 131 
WIDTH Sets window or control width. | yes | percentage or pixels | (none) | page 132 
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RealSystem’s advertising extension and SMIL make it easy to insert 


INSERTING ADS IN A PRESENTATION 


advertisements into your streaming presentation. You can include 
GIF ad banners, for example, or have a video ad precede requested 
content. This chapter explains how to place ads in SMIL 
presentations. Before you start, you should understand SMIL as 


described in Chapter 7 beginning on page 79. 


How Ad Streaming Works 


To use RealSystem’s advertising extension, you create a SMIL file that lays out 
requested clips and ad clips. Instead of listing ad clip URLs in SMIL tags such 
as <img/> or <video/>, you write <RealAdInsert/> tags that cause RealServer to 
insert ad URLs automatically. RealServer typically gets these ad URLs from a 
third-party ad server. RealSystem can deliver ads in any format played by 
RealPlayer, including GIF, animated GIF, JPEG, PNG, RealAudio, RealVideo, 
and Flash. 


The URL used to request the SMIL file, not the <RealAdInsert/> tag, 
determines what type of ad appears in place of each <RealAdInsert/> tag. For 
example, your Web page might contain a hyperlink to a SMIL file that looks 
like this: 


<a href="http://realserver.example.com/ramgen/adtag/banner/start.smil”>...</a> 


Here, the URL component /adtag/banner/ indicates that the SMIL file 
contains one or more <RealAdInsert/> tags that RealServer replaces with ad 
URLs. The RealServer administrator might define /adtag/banner/ to mean that 
each <RealAdInsert/> tag is replaced by a single, 486-pixel by 60-pixel banner 
ad. AURL component such as /adtag/rotating_banner/ might indicate banner 
ads that rotate every 30 seconds. Another component such as /adtag/lead_in/ 
might be for RealVideo ads that precede the requested content. 
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To use RealSystem’s advertising extension, you need to work closely with your 
RealServer administrator. The administrator can tell you the sizes and file 
formats of ads available for streaming, the URLs you'll need to use in your 
Web pages, and other important information. RealServer can also generate 
SMIL files containing ads, or insert ads in existing SMIL presentations. This 


lets you serve ads for existing content without having to write or modify SMIL 
files. 


Tip 
Check with your RealServer administrator on the 
availability of the SMIL generation feature for ad 
streaming. This feature can save development time and 
effort when you want to include ads with existing clips 
or SMIL files. 


Displaying Banner Ads 


RealServer can stream a single banner ad or a series of rotating banner ads 
within a SMIL presentation. Each ad includes a hyperlink that, when clicked, 
opens the URL in the viewer’s Web browser. The RealServer administrator 
defines the banner ad size, and determines how much bandwidth each ad 
uses. For rotating banner ads, the administrator determines how frequently 
RealPlayer displays a new ad. 


Note 
Before creating SMIL files with banner ads, check with 
the administrator on banner ad size, bandwidth, type 
(single ad or rotating ads), and rotation frequency. 


Laying Out the Banner Region 


To integrate banner ads with your presentation, you create a SMIL region in 
which the ad image or rotating image series displays. The following SMIL file 
creates an ad banner region above a video region. The video region is 320 
pixels wide by 240 pixels high. The ad banner region is 468 pixels wide by 60 
pixels high, a common size for ad banners. In the SMIL body section, a <par> 
group plays the requested video and banner ads in their respective regions: 
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<smil> 
<head> 
<!--presentation with video clip and ad banner--> 
<layout> 
<root-layout width="488" height="330" background-color="black”/> 
<region id="ad_banner” top="10” left="10" width="468" height="60"/> 
<region id="videoregion” top="80" left="84” width="320" height="240"/> 
</layout> 
</head> 
<body> 
<par> 
<RealAdInsert region="ad_banner” dur="9:00.0” fill="freeze”/> 
<video src="rtsp://realserver.example.com/videos/newsvid.rm” 
region="videoregion”/> 
</par> 
</body> 
</smil> 


The following figure illustrates this layout of a banner ad region above a 
requested video clip. 


Ad Banner Layout 


| Sue er Infinity Health Spa 3 es 








Additional Information 
“Laying Out Multiple Clips” on page 99 explains how to 
set up SMIL regions. 
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Setting Banner Ad Properties 


In the SMIL body, instead of an <img/> tag link to an ad image file, you use a 
<RealAdInsert/> tag that triggers automatic ad insertion. In the SMIL example 
above, the ad insertion tag looks like this: 


<RealAdInsert region="ad_banner” dur="9min” fill="freeze”/> 


When RealPlayer requests a SMIL file with an ad insertion tag, RealServer 
replaces the <RealAdInsert/> tag with a SMIL <img/> tag that includes a src 
attribute pointing to a banner ad or, with ad rotation, a series of banner ads. 
The <RealAdInsert/> tag can also contain SMIL attributes such as 
region="ad_banner” and fill="freeze”. RealServer simply includes these SMIL 
attributes in the replacement <img/> tag. A duration time is needed only when 
using rotating banner ads. 


Specifying Durations for Rotating Banner Ads 


To use rotating banner ads with a live broadcast, do not set a duration time in 
the <RealAdInsert/> tag. RealServer then sends new banner ads to RealPlayer as 
long as it plays the broadcast. For prerecorded content, however, set a duration 
approximately equal to the content length. If the requested content is nine 
minutes long, for example, you would set the ad duration as dur="9min”. 


You specify an ad rotation duration when serving prerecorded content so that 
RealSystem can calculate the presentation length. If you set no duration, 
RealServer assumes you want a continuous ad stream for a live broadcast, and 
it disables RealPlayer’s clip position slider. RealServer then sends new ads 
until the viewer halts the presentation. Although the presentation will play 
OK, it will not fast-forward or rewind. 


You can set the ad duration shorter than the requested content if you do not 
want ads to display for the entire length of the presentation. In this case, a 
fill="remove” or fill="freeze” attribute included in the <RealAdInsert/> tag 
determines if the last ad banner disappears or remains on the screen. 


Do not set the ad duration significantly higher than the length of the content, 
however. RealSystem considers the ad duration when calculating the 
presentation’s total running time. If you set an ad duration of 20 minutes 
with a 10-minute video, for example, RealPlayer indicates in its status bar that 
the presentation lasts 20 minutes. If a viewer moves the RealPlayer clip 
position slider forward to the 15-minute mark, for instance, the video will 
stop. The viewer may conclude that the presentation is flawed. 
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Additional Information 


See “Specifying Timing” on page 88 for more on SMIL 
timing values. 


Interleaving Media Ads with Clips 


Audio, video, and animation are quickly gaining popularity as advertising 
media, with many ad serving companies offering media ads in formats such as 
RealVideo or Flash. With RealSystem’s advertising capability, you can play 
media ads before, between, or within requested clips. You simply create a SMIL 
file that defines when and how ads appear in relation to requested clips. 
Instead of supplying URLs to ad clips, you write a <RealAdInsert/> tag that 
causes RealServer to insert the media ad automatically. 


Note 
The URL for the SMIL file determines the type of media 
ad inserted in place of <RealAdInsert/>. Your RealServer 
administrator sets up these request URLs, and can give 


you information about media ad sizes, formats, and 


bandwidths. 


Tip 
Always account for the higher bandwidth requirements 
of media ads. Ensure that your target audience has 
sufficient bandwidth to receive the ad as well as the 
requested clips. For more on bandwidth, see Chapter 3 
beginning on page 31. 


Creating a SMIL File for a Media Ad 


To use media advertising, create a SMIL file that organizes all clips, whether 
ad clips or requested content. For a media ad, use a <RealAdInsert/> tag in place 
of a clip source tag such as <video/>. Media ads typically play before or between 


requested clips. Their number, placement, and timing depend entirely on how 
you construct the SMIL file. 


SMIL File with No Regions 


The following SMIL file has no layout. It simply plays two video clips in 
sequence. The first clip is the media ad: 
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<smil> 
<body> 
<seq> 
<RealAdInsert/> 
<video src="rtsp://realserver.example.com/video/video.rm"/> 
</seq> 
</body> 
</smil> 


SMIL File with No Regions 


In the preceding example, the lack of SMIL regions causes the RealPlayer 
display window to resize automatically for each clip. To prevent resizing, or to 
lay out clips that play together, define SMIL regions for the clips. Here’s an 
example of one video region defined for two clips played in sequence: 
<smil> 
<head> 
<layout> 
<root-layout width="240" height="180"/> 
<region id="videoregion” width="240” height="180"/> 
</layout> 
</head> 
<body> 
<seq> 
<RealAdInsert region="videoregion” /> 
<video src="rtsp://realserver.example.com/video/video.rm" 
region="videoregion” /> 
</seq> 
</body> 
</smil> 


The <RealAdInsert/> tag above includes the SMIL region attribute to associate 
the ad with the correct SMIL region. You can include other SMIL attributes, 
such as the dur or fill attribute, in a <RealAdInsert/> tag as well. 


Additional Information 
“Laying Out Multiple Clips” on page 99 explains how to 
set up SMIL regions. 


Disabling the RealPlayer Playlist 


When a media ad and a requested clip play in sequence, the viewer can skip the 
ad clip by choosing the requested clip in the RealPlayer playlist. To disable the 
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playlist through SMIL, encapsulate the <seq> group in a <par> tag. This also 
helps reduce the second clip’s preroll. Here’s an example: 


<smil> 
<body> 
<par> 
<seq> 
<RealAdInsert/> 
<video src="rtsp://realserver.example.com/video/video.rm"/> 
</seq> 
</par> 
</body> 
</smil> 


Additional Information 
For more on the RealPlayer playlist, see “Managing the 
Playlist” on page 96. 


Playing Interstitial Ads 


By using SMIL’s clip timing commands, you can insert media ads within a 
requested clip. The following example inserts three media ads into a long 
video called news.rm. The effect is similar to a television program with 
commercial breaks: 


<smil> 
<head> 
<layout> 
<root-layout width="240" height="180"/> 
<region id="videoregion” width="240” height="180"/> 
</layout> 
</head> 
<body> 
<par> 
<seq> 
<video src="news.rm” region="videoregion” clip-end="8.5min"/> 
<RealAdInsert region="videoregion”/> 
<video src="news.rm” region="videoregion” clip-begin="8.5min” 
clip-end="16.75min”/> 
<RealAdInsert region="videoregion”/> 
<video src="news.rm” region="videoregion” clip-begin="16.75min” 
clip-end="24.5min”/> 
<RealAdInsert region="videoregion”/> 
<video src="news.rm” region="videoregion” clip-begin="24.5min”/> 
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</seq> 
</par> 
</body> 
</smil> 


As shown above, the three ad clips and the main video clip, news.rm, are in a 
<seq> group. The news.rm video begins at its normal beginning and plays for 
8.5 minutes. It then stops while the first ad plays. The news.rm clip then 
resumes where it left off, breaking at later intervals for the second and third 
ads. Because the ad clips include no SMIL timing commands, they play from 
their normal beginnings to normal ends. RealServer delivers a new video ad 
for each <RealAdInsert/> tag. 


Additional Information 
For more on clip timing, see “Setting Internal Clip 
Begin and End Times” on page 90. 
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When you finish building your RealSystem presentation, you place 


DELIVERING A PRESENTATION 


the clips on RealServer for streaming. This chapter explains how to 
link your Web page to your presentation. It also describes how a Web 


server can play back some RealSystem presentations. 


Using RTSP and HTTP in URLs 


A RealSystem presentation served by RealServer involves the HTTP and RTSP 
protocols. If you have experience creating Web pages, you know that HTTP is 
the standard protocol Web browsers and Web servers use to communicate. 
Most Web page URLs begin with http:// to make the file download use the 
HTTP protocol. 


As explained in “Hosting a Presentation on a Server” on page 25, RealServer 
and RealPlayer communicate primarily with RTSP, a new protocol designed 
specifically for streaming media. When you assemble a RealSystem 
presentation, it’s important to understand clearly which URLs should begin 
with http:// and which should begin with rtsp://. 


Use rtsp:// in URLs in which RealPlayer requests clips from RealServer. These 
URLs occur in SMIL files (.smil) and Ram files (.ram or .rpm). Use http:// in 
these URLs only if the clips are stored on a Web server instead of RealServer. 
Because a Web server doesn’t use RTSP, you can’t have rtsp://in a URL toa 
clip stored on a Web server. 


Links to a Web server or RealServer within a Web page (.htm or .html) always 
start with http://. Like Web servers, Web browsers don’t use RTSP and can’t 
interpret streaming information sent by RealPlayer over RTSP. The Web 
browser can connect to RealServer through HTTP, though, because RealServer 
can transmit data with HTTP or RTSP. 
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Additional Information 
For more on SMIL file URLs, see “Linking to Clips on 
RealServer” on page 82 and “Linking to Clips on a Web 
Server” on page 84. See also “URL Reference” on page 
192. 


Streaming Clips from RealServer 


When you stream clips from RealServer, the RealServer administrator creates 
content directories and tells you the basic URLs to use. The administrator can 
also set up features such as password authentication and pay-per-view. When 
your media clips and SMIL file are ready, transfer them to RealServer and 
place them in the directories prepared by the administrator. Then link your 
Web page to your presentation as described below. 


Tip 
Because earlier versions of RealServer do not support 
SMIL and RTSP, ensure that RealServer hosts your 
presentation. Also note that RealNetworks production 
tools can transfer files to RealServer automatically. See 
hetp://www.realnetworks.com/products/index.html 
for details. 


When you use RealServer, the Ramgen feature can automatically launch 
RealPlayer, eliminating the need to write a separate Ram file. Your Web page 
URL simply points to your media clip or SMIL file on RealServer and includes 
a ramgen parameter. The next figure illustrates the process of requesting a 
presentation through Ramgen. This example uses a SMIL file that coordinates 
multiple clips, but you can also link to a single clip directly without using 
SMIL. 
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Requesting a Presentation from RealServer using Ramgen 


Ramgen 
Web Browser 
> 1 (http 
2 (http 
Ze Ome 2 
aC C) 3 (rstp) 
SMIL 


4 (rtsp) 
( - eeceeene @ 
RealPlayer 


RealServer 


1. Using the HTTP protocol, the Web browser requests the SMIL file from 
RealServer. The URL includes a parameter that invokes Ramgen. 


2. RealServer’s response causes the Web browser to launch RealPlayer as a 
helper application and give it the URL to the SMIL file. 


3. RealPlayer requests the SMIL file from RealServer using the RTSP 
protocol. 


4. With the information in the SMIL file, RealPlayer requests and receives 
the streaming media clips. 


Linking your Web Page to RealServer 


With your clips on RealServer, link your Web page to the SMIL file with an 
HTML hypertext link that looks like this: 

<a href="http://realserver.example.com:8080/ramgen/sample.smil”>...</a> 

If the presentation plays back directly in the Web page through RealPlayer’s 


Netscape plug-in, the URL occurs within an <EMBED> or <OBJECT> tag and 
looks like this: 


SRC="http://realserver.example.com:8080/ramgen/sample.smil?embed” 
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The following table explains the components of these URLs. Contact your 


RealServer administrator to get the actual RealServer address, HTTP port, and 


Ramgen directory structure. 


URL Components in a Web Page Link to RealServer 


URL Component 


Meaning 





http:// 


This makes the browser contact RealServer through the 
HTTP protocol. (Web browsers do not use RTSP.) 





realserver.example.com 


This address varies for each RealServer. It typically uses 
an identifier such as realserver instead of www. It may 
also use a numeric TCP/IP address such as 204.71.154.5. 





78080 


This is the port RealServer uses for HTTP connections. 
Separate the port and address with a colon. You can leave 
the port number out if RealServer uses port80 for HTTP 
connections. Include the port number if RealServer uses 
any port besides 80 for HTTP. 





/ramgen/ 


As “Using Ramgen” explains, this parameter launches 
RealPlayer without the use of a separate Ram file. 





sample.smil 


This is the SMIL file for your presentation. If you have 
just one clip to stream, you can link directly to that clip 
instead of a SMIL file. 





?altplay=file. ext 


This Ramgen option specifies an alternate presentation 
created for older versions of RealPlayer. See “Listing 
Alternate Presentations with Ramgen” on page 161. 











?embed This Ramgen option embeds the presentation in a Web 
page. See Chapter 9 starting on page 129 for full 
information on Web page playback. 

Using Ramgen 


In your Web page hyperlink, the /ramgen/ parameter causes the Web browser 


to launch RealPlayer without the use of a separate Ram file. This parameter 


designates a virtual directory on RealServer. It may be followed in the URL by 


actual directory listings, as in this example: 


<a href="http://realserver.example.com:8080/ramgen/media/sample.smil”>..</a> 


You should use Ramgen even when linking to a single clip, such as a RealVideo 


(.rm) clip, that automatically launches RealPlayer. If you cannot use Ramgen, 


you can write the Ram file as described in “Creating a Ram File Manually” on 


page 16S. 
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Listing Alternate Presentations with Ramgen 


When you update content for RealSystem, you can keep existing content 
available for earlier versions of RealPlayer. Suppose you have a RealVideo 5.0 
clip that you want to encode with a RealSystem G2 codec and lay out with 
SMIL. After re-encoding the source file with the new codec and writing the 
SMIL file, you change the link to the 5.0 Ram file to point to the SMIL file, 
using the Ramgen altplay option to list the older clip as an alternate: 


<a href="http://.../ramgen/sample.smil?altplay=old_sample.rm”> 


This link instructs RealServer to point RealPlayer G2 or higher to sample.smil. 
Earlier versions of RealPlayer receive the URL to the older old_sample.rm file. 
Note that the URL specifies the actual clip, not the old Ram file. The older 
clip must reside in the same directory as the new clip or SMIL file. 


Tip 
It is not necessary to keep older content available. If you 
do not use altplay, page visitors using older versions of 
RealPlayer are prompted to upgrade when they click the 
link to the SMIL file. 


Combining Ramgen Options 


The question mark operator (“?”) separates Ramgen options from the main 
URL. To use multiple Ramgen options, you use a question mark before the 
first option, then separate the remaining options with ampersands (“&”). The 
order of options does not matter. For example, the following link uses altplay 
and embed: 


<a href="http://.../ramgen/sample.smil?embed&altplay=old_sample.rm”> 
You can use the question mark operator to include earlier Ram file options 
when using altplay. If your Ram file URL for a RealVideo 5.0 presentation 


specified an end time, for example, include that option in the Ramgen URL 
after altplay. The following shows an end time set for old_sample.rm: 


<a href="http://.../ramgen/sample.smil?altplay=old_sample.rm&end=7:45"> 


Playing Clips from a Web Server 


If you do not have access to RealServer, you can host your presentation on a 
Web server. Although not as robust as RealServer streaming, Web server 
playback provides a reasonable method for sending simple presentations to a 
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small number of users. It is not recommended for lengthy or complicated 
presentations, however, or for clips viewed simultaneously by large groups. 


As described in “Launching a Presentation” on page 26, a Ram file launches 
RealPlayer when the presentation plays back from a Web server. You therefore 
need to write the Ram file as described in “Creating a Ram File Manually” on 
page 165 and place it on the Web server. The following figure illustrates the 
process of requesting a presentation from a Web server. All network actions 
use the HTTP protocol. 


Requesting a Presentation from a Web Server 


4 (http) Web Browser 
2 nig i. 


a7 
ré 5 (htt 
“ RealPlayer 
Web Server 


1. The Web browser requests the Ram file from the Web server. 
2. The Web server downloads the Ram file to the browser. 


3. The Ram file extension (.ram or .rpm) causes the Web browser to launch 
RealPlayer. The .ram extension launches RealPlayer as a separate 
application. The .rpm extension plays the presentation within the Web 


page. 


Additional Information 
For more information on embedding a presentation ina 
Web page, see Chapter 9, starting on page 129. 


4. RealPlayer receives the Ram file and requests the SMIL file from the Web 
server. Alternately, the Ram file can simply list a single clip or multiple 
clips played in sequence. 
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5. With the information in the SMIL file, RealPlayer requests and receives 
the clips from the Web server. 


Limitations on Web Server Playback 


As noted in “Hosting a Presentation on a Server” on page 25, a presentation 
downloaded from a Web server is more likely to stall than a presentation 
streamed by RealServer. Web servers are not designed to manage bandwidth or 
keep multiple clips synchronized.To ensure that a presentation hosted by a 
Web server plays as smoothly as possible, observe the following points. 


No SureStream Clips Encoded for Multiple Bandwidths 


A Web server cannot stream just one encoding from a SureStream clip 
encoded for multiple bandwidths. Instead, it downloads the entire clip file, 
causing an unacceptably high preroll. So you must encode each clip for just 
one bandwidth. To support multiple bandwidths, encode separate clips for 
various bandwidths and use SMIL to let RealPlayer choose which clip to play. 


Additional Information 
For more on using SMIL to list clip choices, read 
“Setting Bandwidth Choices” on page 94. 


Limited Ability to Keep Parallel Clips Synchronized 


A Web server does not consider clip timelines when downloading data and 
does not receive feedback from RealPlayer. Web server playback therefore 
makes it harder for RealPlayer to keep clips synchronized. A presentation that 
plays clips in parallel may begin to stall and rebuffer data when the RealPlayer 
connection has little bandwidth to spare. 


For this reason, it may be difficult to deliver Flash, which consists of 
synchronized animation and audio. You can, however, combine a large clip 
such as RealVideo with smaller clips, such as image clips or a RealText clip. 
Because RealText consumes little bandwidth, a Web server can download it to 
RealPlayer quickly without interfering with other clips. 


RealPix Presentations Buffer Longer 


When delivered by RealServer, images in a RealPix presentation stream at 
different times depending on their place in the RealPix timeline. This lets you 
structure a RealPix presentation to keep it flowing smoothly. When delivered 
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by a Web server, however, all RealPix images begin to download as soon as 
presentation playback begins. This causes a higher preroll. 


Additional Information 
RealPix Authoring Guide explains bandwidth usage when 
RealServer streams RealPix. This guide is available at 
http://service.real.com/help/library/encoders.html. 


SMIL File Optional 


When delivering a single clip or a few clips played in sequence, you do not need 
a SMIL file. You can simply list the clips in order when writing your Ram file 
as described in “Creating a Ram File Manually” on page 165. You can, however, 
have your Ram file specify a SMIL file that lists the clip locations, creates a 
layout, times the presentation, and so on. 


SMIL Internal Timing Commands not Usable 


Although you can use SMIL to lay out and time your presentation, you should 
not use the clip-begin and clip-end attributes. A Web server cannot begin to 
download a clip at a certain point in its timeline. If you specify clip- 
begin="5min”, for example, RealPlayer must wait until it has received the first 
five minutes of clip data before it can begin to play the clip back. This creates 
an unacceptably long wait. 


Additional Information 
“Setting Internal Clip Begin and End Times” on page 90 
describes these SMIL commands. 


No Ad Insertion 


The RealSystem ad insertion feature, described in Chapter 10 beginning on 
page 149, does not work with Web servers. Only RealServer can replace 
<RealAdInsert.../> tags in SMIL files with URLs to ad clips. 


No RealPlayer Seeking 


Because a Web server cannot jump to a new position in a clip timeline, the 
RealPlayer position slider cannot fast-forward the clip. If the user moves the 
slider forward, playback pauses as the clip continues to download at its 
normal rate. RealPlayer resumes playback once the clip data reaches the 
requested timeline position. 
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No RTSP URLs 


Because Web servers do not support the RTSP protocol, all URLs in 
presentations hosted by a Web server should begin with http://. This includes 
all URLs in a SMIL file or Ram file. 


No Live Broadcast 


Live broadcast is not possible because Web servers can download only clips 
stored on disk. 


Configuring Web Server MIME Types 


To download a RealSystem presentation from a Web server, the server must be 
configured with the following MIME types. If you are using an ISP, ask the 
ISP’s Web server administrator to configure the MIME types listed in the 
following table. 


Web Server MIME Types for RealSystem Files 























File Type Extension MIME Type 

Ram .ram audio/x-pn-realaudio 
Embedded Ram | .rpm audio/x-pn-realaudio-plugin 
SMIL .smil and .smi | application/smil 

RealAudio ta audio/x-pn-realaudio 
RealVideo rm application/x-pn-realmedia 
RealPix .p image/vnd.rn-realpix 
RealText ert text/vnd.rn-realtext 











Creating a Ram File Manually 


Whenever possible, launch RealPlayer automatically with RealServer’s 
Ramgen feature as described in “Using Ramgen” on page 160. In some cases, 
though, you may need to write a Ram file: 


- Streaming from a RealServer not set up to use Ramgen. 
- Streaming multiple SMIL files in sequence. 
- Hosting a RealSystem presentation from a Web server. 


+ Playing back clips that reside on the user’s local machine. 
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> To create a Ram file: 


1. Open any editor or word processor that can save files as plain text. On the 
top line, enter the full URL of the SMIL file or the media clip. As shown 
below, URLs vary with the playback context. 


- RealServer Streaming 
The following example links to a SMIL file on a RealServer machine 
that does not use Ramgen: 
rtsp://realserver.example.com/media/sample1.smil 
To deliver a few clips or SMIL files in sequence, list the URLs in their 
playback order: 


rtsp://realserver.example.com/media/sample1.smil 
rtsp://realserver.example.com/media/video1.rm 
rtsp://realserver.example.com/media/sample2.smil 
Web Server Playback 


For Web server playback, you specify the HTTP protocol and the Web 
server name, along with the SMIL file or media clip: 


http://www.example.com/media/video1.rm 

To deliver a few clips or SMIL files in sequence, list the URLs in their 
playback order: 

http://www.example.com/media/video1.rm 


http://www.example.com/media/video2.rm 
http://www.example.com/media/sample1.smil 


Local Playback 


For local playback of clips residing on the user’s machine, start the 
URL with file:// and list clips in their locations relative to the Ram 
file. For example, the following specifies a clip that resides one level 
below the Ram file in the media directory: 


file://media/video1.rm 
To deliver a few clips or SMIL files in sequence, list the URLs in their 
playback order: 


file://media/video1.rm 
file://media/video2.rm 
file://media/sample1.smil 
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Additional Information 
These local URLs are like those used in a SMIL file to 
locate media clips. For more information on general 
URL syntax, see “Specifying Clip Locations” on page 81. 


2. For a presentation played back from RealServer, you can support earlier 
versions of RealPlayer (such as RealPlayer 4.0 or 5.0) just as Ramgen does 
with the altplay option. To do this, add the marker --stop-- after the RTSP 
URL. Then specify the URL for the older clip just as it appeared in your 
previous Ram file. Here’s an example: 
rtsp://realserver.example.com:554/sample.smil 
--stop-- 
pnm://realserver.example.com:7070/old_sample.rm 
The second URL specifies the older RealSystem protocol with pnm:// and 
designates RealServer’s PNA port. When RealPlayer connects, it chooses 
the URL based on its favored protocol. For this reason, you cannot list two 
URLS that both use the same protocol, whether rtsp://, pnm://, or http://. 


3. Save the Ram file as plain text with a.ram extension (played in RealPlayer) 
or a .rpm extension (played in the Web browser). 


4. Move your Ram file to RealServer or your Web server. Keep in mind that 
even if all your media clips are on RealServer, you can place the Ram file 
on your Web server. When the browser receives the Ram file from the Web 
server, it turns the file over to RealPlayer, which uses the full URLs in the 
Ram file to request the clips off RealServer. Hence the Ram file and the 
media clips do not need to reside on the same machine. 


5. For .ram files, link your Web page to the Ram file with an HTML 
hyperlink such as this: 
<a href="http://www.example.com/media/sample.ram”>click for video</a> 
For .rpm files, incorporate the link URL in the <EMBED> or <OBJECT> tag as 
described in “Setting Basic Parameters” on page 131. If the Ram file is on 
RealServer, the URL must not use the ramgen parameter. 


Changing a Presentation’s Starting Size 


Through the Ram file, you can make a clip or SMIL presentation play back at 
double its normal size. You can also set the clip or presentation to open at the 
monitor’s full screen size. Full-screen mode hides all windows, making the 
user’s monitor look like a television screen. To set the screen size, simply add 
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one of the following to the end of the clip or presentation URL in the Ram 


file: 
?screensize="double” 


?screensize="full” 


?screensize=" original” 


Opens clip or presentation at double its normal size. 
Starts clip or presentation in full-screen mode. 


Opens clip or presentation at its normal size. This is the 
default behavior that occurs you leave screensize out. 


This example opens a SMIL presentation at full screen: 


rtsp://realserver.example.com/media/sample1.smil?screensize=" full” 


The following example opens a RealVideo clip at double its normal size: 


rtsp://realserver.example.com/media/videol.rm?screensize="double” 


Note 


The screen size feature is not available when you use the 


Ramgen utility instead of a Ram file. 


Guidelines for Setting a Starting Clip Size 


If you plan to use double or full-screen mode when launching a clip or 


presentation, be sure to follow these guidelines: 


- RealPlayer may not offer full-screen mode on all operating systems. This 


mode is generally available on Windows computers with DirectX 


technology. If RealPlayer for a certain operating system does not offer full- 


screen mode, it plays the presentation at its normal size. 


- If RealPlayer offers full-screen mode but has not yet played a clip full- 


screen, it may first perform a test of this playback mode. 


» The double and full-size modes work best for high-speed clips. They are 


not recommended for presentations delivered through modems. 


- Always test playback when using double and full-size modes to ensure 


that the visual quality is acceptable. Some types of clips may not scale well. 


- In full-screen mode, the user can control RealPlayer through a context 


menu available by right-clicking (on Windows) or holding down the 


mouse button (on Macintosh). 


- With RealPlayer 7 and higher, you can launch new windows in double and 


full-screen modes, too. For more information, see “Popping Up New 


RealPlayer Windows” on page 121. 
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Adding Comments to a Ram File 


You can add a comment to a Ram file by using a pound sign (“#”) as the first 
character on a line. The following example shows two lines commented out of 
a Ram file: 

# Two videos and a SMIL presentation 

# streamed from RealServer. 

rtsp://realserver.example.com/media/video1.rm 
rtsp://realserver.example.com/media/video2.rm 
rtsp://realserver.example.com/media/sample2.smil 


Testing your Presentation 


The following are guidelines for making sure your presentation works well 


and reaches its target audience: 


1. Test your presentation in “real world” conditions. If you target 28.8 Kbps 
connections, for example, request the presentation over a 28.8 Kbps 
modem. 


2. Check that the presentation has a preroll (initial buffering) under 15 
seconds. After preroll, the presentation should not rebuffer under normal 
network conditions. 


Additional Information 
“What is Preroll?” on page 32. 


3. Verify that video and audio quality is acceptable. 


4. For a multiclip presentation, verify that clips stay synchronized. Ensure 
that no stalling occurs because too many clips play at the same time or a 
single clip requires too much bandwidth. Test that clips introduced 
during a presentation in progress do not stall playback by requiring too 
much buffering when they start. 


Tip 
If clips introduced during a presentation in progress 
require too much buffering, see “Smoothing Transitions 
between Clips” on page 195. 


5. Make sure that your presentation works well for an “average” CPU for 
your audience. For general Web delivery, test playback on both Pentium 
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and Power Macintosh 90 MHz machines. Do not rely on MMX technology 
to enhance playback. Not all Web users have MMX machines. 


Tip 
If your presentation is CPU-intensive because, for 
example, it uses complex Flash animation or high- 
bandwidth video, note this in your Web page. 


6. When streaming RealAudio, ensure that sound quality is acceptable. You 
may need to experiment with RealAudio codecs to find the best balance 
between clip bandwidth use and sound quality. 


7. When embedding a presentation in a Web page, verify that the playback 
window has the correct location and controls. 


Advertising on RealGuide 


Every day, thousands of people visit RealGuide, RealNetworks’ online guide 
for streaming media sites and live events (http://realguide.real.com/). If you 
regularly host streaming media presentations of interest to the public, or you 
have a live event you want to advertise, you can submit your listing to 
RealNetworks. Simply complete an online form to list your site or live event: 


- http://realguide.real.com/info/?page=submit 


In the form, you give the site or event name, URL, short description, and 
contact person. A staff member then verifies your site or event before 
including it on RealGuide. (RealNetworks reserves the right to refuse or edit 
submissions.) For live events, please submit your request at least one business 
day in advance. If you have questions or need to change a listing, please e-mail 
RealGuide through http://realguide.real.com/info/?page=fbform. 
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The Internet is swiftly becoming the next great broadcast medium. 


BROADCASTING A PRESENTATION 


RealSystem lets you broadcast live or prerecorded presentations over 
the Internet or an intranet. This chapter provides background on 
using broadcast applications and RealServer to broadcast media. 
Refer to your tools and RealServer manuals for explicit instructions 


on setting up a broadcast. 


Broadcasting vs. On-demand Delivery 


When a streaming presentation is delivered on demand, it starts from its 
beginning when the viewer clicks the presentation link in a Web page. Each 
viewer can receive the presentation at any time and use RealPlayer’s controls to 
fast-forward or rewind through the presentation. 


In a streaming broadcast, however, the user hosting the broadcast starts the 
presentation at a certain time. Viewers who click the presentation link join the 
broadcast in progress. Before the broadcast begins and after it completes, the 
presentation URL is not valid. During the broadcast the RealPlayer fast- 
forward and rewind controls do not function. 


To make an analogy, on-demand content is like a movie on videotape. The 
viewer can see it at any time, skip forward, rewind, and pause. A streaming 
broadcast, though, is like a movie shown on a television channel. As with a TV 
broadcast, there are two types of streaming media broadcasts: 


« Live content 


Live content is broadcast as it occurs. For example, you can broadcast the 
output of a video camera across the Internet or an intranet. RealSystem 
encodes the content as RealVideo in real-time without writing the content 
to a RealVideo clip first. 
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- Prerecorded content 


Prerecorded content consists of video or audio you record and write to a 
digitized clip. You can then edit the clip before converting it to a 
streaming format and broadcasting it across a network. To the viewer, the 
presentation looks just like a live broadcast. 


Broadcasting Live or Prerecorded Content 


Live Content RealServer 
> | ee 

“®@ a@ a® 

Prerecorded Cr Soe eh eee 


Clip RealServer RealPlayers 
«\ ee 


os oe RealPlayers 


Broadcasting Tools 


To broadcast a presentation, you need the tools described in the following 
sections. 


Source Capture Equipment 


This equipment captures the broadcast content. It is typically a microphone or 
video camera connected to an audio or video capture card. For text it could be 
a live text feed coming in over a network. 


Editing Equipment 


When you broadcast prerecorded content, you first write the source to a 
digitized file. You can then use editing software to optimize the file for 
broadcast. Live content, however, goes directly from the capture equipment to 
the broadcast application. 


Broadcast Application 


The broadcast application takes the live source and encodes it in the 
appropriate streaming format, sending the output to RealServer. A RealVideo 
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broadcast application, for example, encodes a camera’s video output as 
RealVideo in real-time. A broadcast application typically runs on a separate 
machine that has a network connection to the RealServer machine. To 
broadcast prerecorded content, you typically do not need a broadcast 
application because RealServer can broadcast the clips itself. 


RealNetworks encoding tools have live broadcast capability for audio and RGB 
or YUV video. They guide you through the broadcast process and let you 
connect to RealServer easily. RealSystem’s open architecture also lets you build 
a broadcast application to send RealServer any type of data for broadcast. To 
build a broadcast application, you need the RealSystem Software 
Development Kit (SDK). 


Additional Information 
You can get RealAudio and RealVideo encoding tools 
from http://www.realnetworks.com/products/. 
Sample RealText and RealPix broadcast applications are 
available in the RealSystem Authoring Kit at 
hetp://www.realnetworks.com/products/authkit/. 
You can download the entire RealSystem SDK from 
hetp://www.realnetworks.com/devzone/. 


RealServer 


RealServer streams the broadcast to RealPlayer. The RealServer administrator 
can give you the broadcast URL and parameters for connecting a broadcast 
application to RealServer. Because each RealServer has a limit on the number 
of streams it can produce, verify that the RealServer you intend to use has 
broadcast capabilities appropriate for your anticipated audience size. 


Tip 
Real Broadcast Network (RBN) provides full services for 
broadcasting small and large events. For details, see 
hetp://www.realnetworks.com/rbn/. 


Additional Information 
For information on configuring a broadcast, get 
RealServer Administration Guide, available at 
hettp://service.real.com/help/library/servers.html. 
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Preparing a Broadcast 


The following are tips for preparing a live or prerecorded broadcast. See the 
manual or online help for your broadcast application for explicit instructions 
on how to encode and broadcast content. 


Use SureStream with RealSystem G2 Codecs 


SureStream technology and RealSystem G2 codecs let you broadcast 
RealAudio or RealVideo at multiple bandwidths. Each viewer’s RealPlayer 
selects an encoding appropriate for its connection speed. RealNetworks 
encoding tools let you specify SureStream when you begin the broadcast. 


Multiple-Bandwidth Broadcast through SureStream 


RealPlayers 
e te @ 
e@ 
e@ 28.8 Kbps 
e 
| @ 
@ 

near ogeccceee Og 

SureStream aGnnpS 
Clip 

te @ 

112 Kbps 


To broadcast without using SureStream and the RealSystem G2 codecs, you 
need a separate broadcast application running on a separate computer for 
each bandwidth connection you intend to support. This is required because 
older codecs require more CPU for each encoding than do RealSystem G2 
codecs. You then connect each broadcast application to RealServer and 
broadcast the different encodings under different URLs. 


Additional Information 
For more on codecs, see “Choosing RealAudio Codecs” 
on page 49 and “Choosing RealVideo Codecs” on page 
61. 
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Verify that the Broadcast Machine has Enough CPU Power 

RealNetworks tools can broadcast a SureStream clip for several different 
bandwidths in real-time using just a moderately powerful PC. Refer to your 
broadcast application’s manual or online help for guidelines on machine 
requirements for broadcasting. 


Decide Whether to Archive a Live Broadcast 


RealNetworks encoding tools let you write a live broadcast to a file. RealServer 
can also archive the broadcast to a file. The latter option may be the better 
solution if your broadcast is long and your broadcast machine has limited 
disk space. The RealServer administrator can set up RealServer to archive the 


live broadcast. 


Get the Broadcast URL and RealServer Parameters 


The RealServer administrator can give you the parameters you need to 
connect a broadcast application to RealServer. The administrator will also 
provide the broadcast URL or URLs. 


Perform a Trial Run of a Live Broadcast 


When you broadcast live content, you don’t get a second chance. It’s good 
practice to perform a trial run to ensure that the equipment works properly 
and the broadcast results are what you expect. Because you can’t edit a live 
broadcast the way you can edit a prerecorded file, it’s important to set your 
audio levels and plan your video shots carefully in advance. 


Additional Information 
For pointers on producing audio, see “Capturing 
Audio” on page 45. For video, see “Recording Video” on 
page S7. 


During both the trial run and the live broadcast, view the broadcast output 
with RealPlayer. When RealPlayer connects, check that the buffering time for 
receiving a live stream does not exceed 5-10 seconds. Throughout the 
presentation, keep an eye on the broadcast quality. 


If you experience problems with the broadcast output, use the broadcast 
application to lower the video frame size and frame rate (fps), or select lower- 
bandwidth codecs. If these adjustments do not help, you may need to run your 
broadcast application on a more powerful machine. 
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Advertise a Public Broadcast Event 


If you are broadcasting content that has wide public appeal, advertise your 
event on RealGuide (http://realguide.real.com/), RealNetworks’ online 
guide to streaming media. 


Additional Information 
See “Advertising on RealGuide” on page 170. 


Using SMIL with a Broadcast 


You can use SMIL to coordinate live streams or create a presentation that adds 
prerecorded content to a live broadcast. The following sections gives you tips 
on using SMIL with broadcasts. 


Additional Information 
See Chapter 7 beginning on page 79 for more on SMIL. 
Chapter 10 beginning on page 149 tells how to include 
ads in broadcasts. 


SMIL Limitations for Broadcasts 


Within a SMIL file, you treat a broadcast like any other clip. You can assign 
broadcast streams to SMIL regions and group a broadcast with on-demand 
clips in a <seq> or <par> group, for example. However, you cannot use some 
SMIL features with broadcast streams: 


- You cannot replay a broadcast with the SMIL repeat attribute. 


+ The clip-begin and clip-end attributes do not work with broadcasts. You 
can terminate a broadcast before the stream stops by using the SMIL end 
attribute, however. 


Additional Information 
See “Setting Begin and End Times” on page 89. 


Including On-Demand Clips with Broadcasts 


Using SMIL, you can easily embed a broadcast in a multiclip presentation. 
SMIL can deliver an on-demand RealPix slideshow along with live RealAudio, 
for example, when both are in a <par> group. It cannot synchronize the on- 
demand clip to the live stream, however. The on-demand clip’s timeline starts 
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when the viewer requests the presentation. The broadcast stream’s timeline 
starts when the broadcast begins. 


To illustrate this, suppose viewer A requests the presentation two minutes 
after the broadcast begins, while viewer B requests it four minutes after the 
broadcast begins. At ten minutes into the broadcast, both A and B hear the 
same audio, but viewer A’s RealPix clip is at its eight-minute mark, whereas 
viewer B’s clip is at its six-minute mark. Hence the relationship of the two 
timelines varies for each viewer. 


Synchronizing Multiple Broadcast Streams 


If you have multiple broadcast streams for a single presentation, you can 
synchronize the streams through SMIL. This compensates for the fact that 
you typically cannot start two broadcast applications at exactly the same time. 
For example, you might start a live RealText encoding application a few 
seconds before a live RealVideo stream. When it receives the streams, 
RealPlayer delays playing the RealText stream until it can synchronize it with 
the RealVideo stream. 


Tip 
RealPlayer synchronizes broadcast streams to audio. For 
this reason, start your audio/video broadcast 
application last. This way RealPlayer will have received 
and buffered the other streams by the time it receives 
the audio. 


The broadcast streams are timestamped according to the broadcast machines’ 
internal clocks. You should therefore run broadcast applications on the same 
machine, or on different machines that have synchronized clocks. To make 
RealPlayer synchronize streams, add a ?wallclock=name option to the broadcast 
source tag URLs in the SMIL file as shown in this example: 
<par> 
<video src="rtsp://realserver.example.com/encoder/video.rm?wallclock=sync"/> 
<textstream src="rtsp://realserver.example.com/live/text.rt?wallclock=sync"/> 
</par> 


All wallclock attributes should use the same name value (sync in the example 
above), which can be any name you choose. The wallclock attribute is not 
needed for an on-demand clip or a single broadcast stream. 
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Warning 
The wallclock attribute works with all RealNetworks clip 
types, including RealAudio, RealVideo, RealPix, and 
RealText. It may not function with other clip types 
broadcast by RealServer, however. 


Additional Information 
Sample RealText and RealPix broadcast applications are 
available in the RealSystem Authoring Kit at 
hetp://www.realnetworks.com/products/authkit/. 
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If yow’re a beginner, this appendix answers common questions 
about producing streaming media clips for RealSystem. It also 
supplies Web URLs where you can find tools and helpful 


information about developing streaming media presentations. 


Creating Streaming Clips 


RealProducer is the basic tool for creating clips. The RealProducer manual or 
online help guides you through the encoding process. This production guide 
gives you background information and tips on creating high-quality 
streaming media. 


How do | make Streaming Audio and Video Clips? 


You start with an audio or video source file in a digitized format on your 
computer. You then use RealProducer’s encoding wizard to select the file and 
set encoding options. The encoding process creates a new streaming clip, 
leaving the source file unchanged. 


Can | Encode RealVideo Directly from a Video Camera? 


Yes. RealProducer accepts live video input from a camera and live audio input 
from a microphone. The camera and microphone connect to an audio/video 
capture card on your computer. RealProducer’s encoding wizard then lets you 
select the live input as the source. In this case you go directly from live input to 
encoded clip without creating a digitized source file. 


How do | Ensure the Best Quality for Streaming Clips? 


Quality starts at the source. You need high-quality video and audio input for 
RealProducer to create high-quality streaming clips. Chapter 4 and Chapter 5 
give some tips on producing good audio and video, respectively. If you are new 
to media production, learn your media editing hardware and software 
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thoroughly, paying close attention to the manufacturers’ recommendations 
for producing high-quality media files. 


What Other Clips can | Stream? 
In addition to audio and video, RealSystem can stream these types of clips: 
+ Shockwave Flash animation by Macromedia 
+ GIF, JPEG, and PNG images 
- RealPix for streaming slideshows 


- RealText for streaming text 


Getting Production Tools 


To produce streaming media clips, you need audio and video production tools 
as well as RealProducer to handle the encoding. 


What Audio and Video Editing Tools can | Use? 


You can use any hardware or software designed for capturing and editing 
audio and video. The digitized output must be in a format that RealProducer 
accepts, however. Some video editing programs save digitized video in a 
proprietary format that RealProducer can’t read. However, they typically let 
you export the video to a common format (such as AVI, QuickTime, or MPEG) 
that RealProducer accepts. 


Tip 
You can purchase hardware and software for capturing 
and editing audio and video from RealStore at 
hetp://www.realstore.com. 


What Digitized Audio and Video Formats does RealProducer Accept as Input? 


RealProducer accepts many common audio and video formats. These may vary 
by operating system, though. RealProducer on Macintosh accepts the formats 
widely used on the Mac, such as QuickTime, while RealProducer on Windows 
or Unix supports the formats widely used on those platforms. Check the 
RealProducer manual for your operating system for a list of accepted formats. 
Information is also available at: 


hetp://www.realnetworks.com/products/producer/freevsplus.html 
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Where can | get RealProducer? 


RealNetworks makes versions of RealProducer for Windows 95/98/NT/2000, 
Macintosh, and Linux. You can download the free version or purchase 


RealProducer Plus at: 


hetp://www.realnetworks.com/products/index.html 


How do | Create a Streaming Slideshow from Still Images? 


Through its graphical interface, RealSlideshow lets you create streaming 
RealPix presentations from still images. It also lets you add a soundtrack and 
voice narrations for each image. You can download RealSlideshow from: 


hetp://www.realnetworks.com/products/index.html 


You can also create RealPix presentations by hand with the RealPix mark-up 
language, which is described in RealPix Authoring Guide, available at: 


hetp://service.real.com/help/library/encoders.html 


How do | Create Streaming Flash Animation? 


You create animation with Flash by Macromedia. RealSystem currently 
streams Flash 2. You can develop animations with Flash 3 or 4, but you must 
export your file in Flash 2 format. Chapter 6 provides tips for making Flash 
animation stream well with RealSystem. It doesn’t explain how to create Flash 
animations, however. You can learn more about Flash at 
hettp://www.macromedia.com/software/flash/. 


What’s the RealSystem Authoring Kit? 


The Authoring Kit bundles several RealNetworks tools and manuals into one 
archive that you can download. This gives you one source for the basic tools 
and information used to create streaming media clips. The Authoring Kit is 
available free at: 


hetp://www.realnetworks.com/products/authkit/ 


Using SureStream 


SureStream provides advanced streaming technology for RealSystem. For 
more on SureStream, read “Using SureStream Clips for Multiple Bandwidths” 
on page 39. 
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What is SureStream? 


SureStream is a technology that lets a single RealAudio or RealVideo clip 
stream at different bit rates. It does this by bundling into a single clip multiple 
streams that each run at a different bit rate. You can make a SureStream clip 
that streams at either 28.8 Kbps or 56 Kbps, for example. When a RealPlayer 
requests the clip, it automatically receives the stream that best suits its 
connection speed. 


How do | make a SureStream Clip? 


RealProducer lets you choose SureStream when you encode audio or video 
input. The number of SureStream streams you can encode in the clip depends 
on the type of RealProducer you use. The free RealProducer encodes two 
speeds per clip, while RealProducer Plus encodes up to six speeds per clip. 


Can | use SureStream with a Web Server? 


No. A SureStream clip has several streams encoded in a single clip. Unlike 
RealServer, a Web server cannot extract a specific stream to send to RealPlayer. 
If you plan to deliver clips with a Web server, you need to choose single-rate 
encoding with RealProducer. 


Writing SMIL Files 


Chapter 7 explains the basics of SMIL. Chapter 8 covers RealNetworks’ 
extensions to SMIL. Appendix D is a quick reference you can use once you 
understand SMIL. 


What is SMIL? 


Pronounced “smile,” SMIL stands for “Synchronized Multimedia Integration 
Language.” It is an industry-standard mark-up language used to lay out and 
time streaming media presentations. SMIL works for RealPlayer the way 
HTML works for a Web browser. 


Is using SMIL Necessary? 


When you want to stream just one clip, such as a single RealVideo clip, you 
don’t need to use SMIL. You just link your Web page to the clip through a 
Ram file. For more information, see “What is a Ram File?” on page 184. 
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When should | use SMIL? 


When you stream multiple clips, SMIL lets you lay out and time the 
presentation. It also provides other features, such as letting you create 
hyperlinks that start a new presentation. See “Writing a SMIL File” on page 22 
for a rundown of basic SMIL features. 


How do | Write SMIL? 


SMIL is a simple mark-up language that you can write with a word processor 
or text editor. Some software tools also write SMIL for you. RealSlideshow 
creates SMIL files automatically, for example. 


Streaming Clips 


You can stream clips yourself with RealServer, through a service provider that 
has RealServer available, or, in some cases, with a Web server. 


Do | need to have RealServer in Addition to RealProducer? 


RealServer streams the clips created by RealProducer. To run it, you need a 
computer on an intranet, or one that has a direct presence on the Internet. 
You can’t run RealServer if you use an Internet Service Provider (ISP) to 
connect to the Internet. Ifyou use an ISP, check to see that they have 
RealServer and can host your streaming presentations for you. 


What Operating Systems does RealServer run on? 


RealServer runs on Windows NT/2000 and many UNIX operating systems, 
including Linux. For a list of available platforms, visit RealNetworks’ technical 
support Web site at http://service.real.com. 


Where do | get RealServer? 


RealServer is available through RealNetworks’ Web site at 
hetp://www.realnetworks.com/products/index.html. The basic RealServer 
is free. 


Can | Stream Clips from a Web Server instead of RealServer? 


A Web server can deliver many clips, including RealAudio and RealVideo. 
There are limits on Web server delivery, however. If you plan to use a Web 
server for clip delivery, read “Limitations on Web Server Playback” on page 163 
first. 
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What is a Ram File? 


A Ram file, also called a “metafile,” is a simple text file with the extension 
ram. A Ram file typically consists of one line: the URL to a streaming 
presentation. Your Web page does not link directly to your presentation. 
Instead, it links to the Ram file, which ensures that RealPlayer launches. 
RealPlayer then uses the URL in the Ram file to request the presentation. 
“Creating a Ram File Manually” on page 165 explains how to write a Ram file. 


Tip 
When you stream clips with RealServer, you can 
eliminate the Ram file by using the Ramgen utility. For 
more information, see “Using Ramgen” on page 160. 


If | use SMIL, do | need a Ram File? 


Yes. The SMIL file lists the URLs for clips, the Ram file gives the URL to the 
SMIL file (or your streaming clip if you’re not using SMIL). The Ram file is 
always necessary because its .ram extension launches RealPlayer. 


Can | Place Clips in a Web Page? 


Yes. Chapter 9 explains how to embed clips and RealPlayer controls in a Web 
page. RealPlayer still plays the clips, but it does so “behind the scenes” as a 
browser plug-in rather than by launching separately. 


Why does RealServer use RTSP Rather than HTTP? 


Web servers use the HTTP protocol to deliver Web pages and graphics. HTTP 
is designed to download small files quickly and efficiently. It is not suited for 
streaming large media clips, though. RTSP, which stands for “Real-Time 
Streaming Protocol,” is an industry-standard protocol that overcomes the 
deficiencies of HTTP for streaming media. It lets RealServer and RealPlayer 
stream long clips and compensate for changing network conditions. 


How do | Stream Clips with RTSP? 


When a clip resides on RealServer, make sure the URL used to request it starts 
with rtsp:// rather than http://. An RTSP URL must be in a file read by 
RealPlayer, such as a Ram file or a SMIL file. It can’t be in an HTML page 
hyperlink because a Web browser does not know how to make an RTSP 
request. For more on this, see “Using RTSP and HTTP in URLs” on page 157. 
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Advertising 


Chapter 10 explains how to stream ads using SMIL. The RealServer 
administrator carries out most of the work for setting up ad streaming, as 
described in RealServer Administration Guide. 


How does Advertising with RealSystem Work? 


Ad streaming uses <RealAdInsert/> tags in SMIL files to designate when and 
where ads appear. When RealServer serves a SMIL file, it replaces the tags with 
URLs to ad files. These URLs come from a separate ad server, and the 
RealServer administrator can configure RealServer to work with virtually any 
ad serving system. 


What Kinds of Ads can | Stream? 


RealServer can stream banner ads in image formats such as GIF, JPEG, and 
PNG. It can display one ad per presentation, or make new ads appear at 
specific intervals while the presentation plays. RealServer can also stream ads 
in RealAudio, RealVideo, or Flash formats. These ads might appear before the 
requested clips, or during the clips as commercial breaks. 


How do | Set Up Advertising? 


You need a RealServer with the optional Advertising Extension. You also need 
to have an ad server, or to sign up with an online ad provider like DoubleClick. 
The RealServer administrator configures RealServer to work with your ad 
serving system, determining what types of ads are streamed. You then write 
SMIL files with <RealAdInsert/> tags that determine where ads are placed. 


Do | have to Write SMIL to Stream Ads? 


No. Writing your own SMIL files gives you a more flexible way to stream ads, 
but RealServer can automatically include ads with requested clips or SMIL 
presentations. If your RealServer hosts a large number of RealAudio or 
RealVideo clips, for example, you can simply let RealServer lay out an ad for 
each clip without writing any SMIL mark-up by hand. 


Broadcasting 


For complete information about broadcasting (also known as “Webcasting”), 
see your RealProducer manual, the RealServer Administration Guide, and 
Chapter 12 of this production guide. 





185 


APPENDIX A: Quick Answers to Common Questions RealSystem G2 Production Guide 





What do | need for Broadcasting on a Network? 


You need the following: 


- An audio or video capture card on your computer to digitize the input 
from a microphone or camera. 


+ On the same computer as the capture card, RealProducer to encode the 
output in a streaming format and send the stream to RealServer. 


+ RealServer to broadcast the stream to various RealPlayers. RealServer 
typically does not run on the same machine as RealProducer. 


Can | Broadcast through my ISP? 


If you connect to the Internet through an Internet Service Provider (ISP), you 
may be able to broadcast, provided that your ISP has RealServer available and 
offers broadcasting services. You'll also need a fast Internet connection to your 
ISP. You cannot broadcast through an ISP by running RealServer on your 
home machine. 


Can | use SureStream in a Broadcast? 


Yes. Using SureStream is recommended because it allows users connecting at 
different speeds to receive the best possible stream. You need to ensure that 
the computer running RealProducer has enough power to encode all the 
SureStream streams at the same time, however. Check your RealProducer 
manual for machine recommendations, and perform a trial run first. 


Can | Broadcast with a Web Server instead of RealServer? 


No, you need RealServer to broadcast. Web servers are meant to serve HTML 
pages and graphics to different users at different times. They are not designed 
to broadcast the same presentation to multiple users. 


Does a Broadcast Have to be Live? 


No. “Broadcasting” means to send out a stream that more than one RealPlayer 
user can view. The broadcast can be live, meaning the input originates from a 
microphone or video. It can also be prerecorded, meaning it originates from a 
digitized clip prepared in advance. If it’s prerecorded, you don’t need to use 
RealProducer during the broadcast. You just put the clip on RealServer and set 
up RealServer to broadcast the clip as a simulated live event. 
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Can | use SMIL with a Broadcast? 


Yes. You can use SMIL to include ads with the broadcast, deliver a static clip 
alongside the broadcast, or anything else. In the SMIL file, you simply treat 
the broadcast as a static clip. The only difference is that you use a special URL 
created by the RealServer administrator that identifies the resource as a 
broadcast rather than a clip. 


How Many People can | Reach with a Broadcast? 


That depends entirely on your RealServer and the network bandwidth it has 
available. Each RealServer can broadcast to a specific number of RealPlayers, 
as defined in its license agreement. For large broadcasts, several RealServers 
can be coordinated in a network to reach many thousands of RealPlayers. 


Can RealNetworks Broadcast Clips for Me? 


Yes. Real Broadcast Network (RBN) offers a wide range of services for hosting 
broadcasts. Learn more about RBN at: 


hettp://www.realnetworks.com/rbn/index.html 


Getting Technical Support 


RealNetworks offers a range of technical support features and documentation 
at http://service.real.com. 


How Do | get Technical Support from RealNetworks? 


RealNetworks technical support operates an extensive Web site at 
http://service.real.com. The site includes answers to frequently asked 
questions, a documentation library, and a searchable knowledge base. To place 
a service call with technical support, fill out the e-mail form at: 


hetp://customerrelations.real.com/scripts/rnforms 
/contact_tech_service.asp 


Where can | find Additional Documentation? 


RealNetworks Technical Support maintains a documentation library at 
hetp://service.real.com/help/library/index.html. Most documents are 
available as bundled HTML archives that you can download, uncompress, and 
read through a Web browser. Many documents are also available in PDF 
format, which is suitable for printing. To read PDF, you need Adobe’s Acrobat 
Reader, which is available at: 
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hetp://www.adobe.com/products/acrobat/readstep.html 


Where should | go for the Latest RealSystem Information? 


The RealNetworks DevZone is the main information site for content authors 
and software developers working with RealSystem products. Find it at: 


hetp://www.realnetworks.com/devzone 
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This appendix provides examples that show how to set up some 
simple streaming presentations quickly. This information will aid 
you if you are a beginning user. Once you are familiar with the basic 
steps for hosting RealSystem presentations, you can easily create 


more complex presentations. 


Note 
You will need to get the correct URLs for media clips 
from the RealServer or Web server administrator. 
Substitute those values for the example URLs shown 
below. 


Streaming a RealAudio or RealVideo Clip 


It’s simple to add a RealAudio or RealVideo clip to your Web page. Following 
the instructions below, you can stream the clip from RealServer or download 
it from a Web server. The clip plays back in RealPlayer. 


Note 
Before using a Web server, read “Hosting a Presentation 


on a Server” on page 25 and “Limitations on Web Server 
Playback” on page 163. 


> To create the clip: 


1. Prepare your audio or video source file for encoding. This can include 
normalizing the audio source file or setting the video’s window size. 


Additional Information 
“Optimizing Audio” on page 47. “Digitizing Video” on 
page 58. 





189 


APPENDIX B: Quick Steps for Streaming Clips RealSystem G2 Production Guide 





2. Use a RealNetworks encoding tool to encode the RealAudio or RealVideo 
clip from your audio or video source file. RealVideo and RealAudio clips 
use the file extension .rm. 


Note 
Encoding tools are available for free download or purchase 
at http://www.realnetworks.com/products/index.html. 


> To stream the clip from RealServer using Ramgen: 


1. Transfer the clip to the RealServer directory prepared by the RealServer 
administrator. 


2. Link your Web page to the clip with an HTML hyperlink that specifies the 
RealServer address, the ramgen parameter, and the HTTP protocol. You 
can get this information from the RealServer administrator. In your 
HTML source file, the link will look like this example: 


<a href="http://realserver.example.com:8080/ramgen/content/myclip.rm”> 
Click here</a> to see my RealVideo presentation. 


Additional Information 
“Streaming Clips from RealServer” on page 158. 


3. In your Web browser, click the link to verify that it works. RealPlayer will 
launch as a helper application and, after a few seconds of buffering, will 
play the streaming clip. 


> To play the clip back from a Web server: 


1. With any text editor, open a new file and enter the URL your clip will have 
on the Web server. For example: 
http://www.example.com/media/myclip.rm 


2. Save this file as plain text with the file extension .ram. This is your Ram 
file. 


Additional Information 
“Creating a Ram File Manually” on page 165. 


3. Transfer the media clip and the Ram file to the appropriate directory on 
the Web server. 


4. Link your Web page to the Ram file (not the media clip) with a standard 
HTML hyperlink like this: 
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<a href="http://www.example.com/media/myclip.ram”> 
Click here</a> to see my RealVideo presentation. 


5. In your Web browser, click the link to verify that it works. RealPlayer will 
launch as a helper application and, after a few seconds of buffering, will 
play the clip. 


Additional Information 


“Playing Clips from a Web Server” on page 161. 


Embedding a RealVideo Clip in a Web Page 


Using RealPlayer’s Netscape plug-in, you can embed a RealVideo clip directly 
in your Web page. The following example assumes that the video is 176 pixels 
wide by 132 pixels high. It places the video window and the full RealPlayer 
control panel in your Web page. 


Additional Information 
See “Chapter 9: Playing Clips in a Web Page” beginning 
on page 129. 


> To embed the clip in your Web page: 


1. In your Web page, add the <EMBED> tag with the RealVideo URL, window 
size, and ImageWindow control. The following example assumes RealServer 
will stream the presentation: 
<EMBED WIDTH=176 HEIGHT=132 
SRC="http://realserver.example.com:8080/ramgen/content/myclip.rm?embed” 
CONTROLS=ImageWindow CONSOLE=one NOJAVA=true> 
If you intend to play the clip back from a Web server, use an HTTP URL 
and link to a Ram file with the extension .rpm (see below) as in the 
following example: 


<EMBED WIDTH=176 HEIGHT=132 
SRC="http://www.example.com/media/myclip.rpm” 
CONTROLS=ImageWindow CONSOLE=one NOJAVA=true> 


2. You can then add RealPlayer controls through additional <EMBED> tags 
that all use the same URL for the SRC parameter. The following example 
embeds the full RealPlayer control panel in the Web page, linking it to the 
image window through the same console. It assumes RealServer will 
stream the presentation: 
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<EMBED WIDTH=375 HEIGHT=100 
SRC="http://realserver.example.com:8080/ramgen/content/myclip.rm?embed” 
CONTROLS=ALL CONSOLE=one NOJAVA=true> 

Use an <EMBED> tag like the following when playing the clip back from a 
Web server: 


<EMBED WIDTH=375 HEIGHT=100 


SRC="http://www.example.com/media/myclip.rpm” 
CONTROLS=ALL CONSOLE=one NOJAVA=true> 


Tip 
Because you can place each <EMBED> tag anywhere on 
your Web page, you can lay out the image window and 
controls in any manner using HTML. 


Additional Information 
Download the HTML version of this manual from 
http://service.real.com/help/library/index.html to 
see online examples of embedded RealPlayer controls. 


3. Transfer the clip to the appropriate RealServer or Web server directory. 
When streaming from RealServer, you are ready to test the clip because 
the Web page already contains the link to the RealVideo clip. 


> To create the Ram file when playing the clip back from a Web server: 


1. With any text editor, open a new file and enter the URL your clip will have 
on the Web server, as in the following example: 


http://www.example.com/media/myclip.rm 


2. Save this file as plain text with the file extension .rpm. This is your Ram 
file. 


3. Transfer the Ram file to the appropriate directory on the Web server. 


4. In your Web browser, click the link to verify that it works. 


URL Reference 


As explained throughout this manual, URLs to files and clips vary depending 
on what kind of file or clip you link to and what type of file contains the link. 
The table below provides a quick reference for the protocol used for various 
types of links. It also shows whether the link should invoke RealServer’s 
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Ramgen utility. This table assumes that the presentation is for RealPlayer G2 
























































or higher. 
Quick URL Reference 
Link from Link to Located on Protocol Ramgen? Reference 
RealServer | http:// es age 158 
Web page Media clip ub ae 
Web server |http:// | no page 161 
RealServer | http:// es age 158 
Web page SMIL file y i 
Web server |http:// | no page 161 
Ram file (.ram RealServer |http:// | no page 165 
Web page 
or .rpm) Web server |http:// | no page 165 
RealServer | rtsp:// no page 82 
SMIL file Media clip Web server |http:// | no page 84 
Local host | file:// no page 84 
RealServer | rtsp:// no page 82 
SMIL file SMIL file Web server |http:// | no page 84 
Local host | file:// no page 84 
RealServer | rtsp:// no page 165 
Ram file beg 
: 1 
(raiiconcvatn) Media clip Web server |http:// | no page 165 
Local host | file:// no page 165 
RealServer | rtsp:// no page 165 
Ram file . 
: 1 
Genera SMIL file Web server |http:// | no page 165 
Local host | file:// no page 165 
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This appendix will help you utilize the many features of RealSystem 
and SMIL. Before following the production tips given here, make 
sure you have a good understanding of SMIL as described in 


Chapter 7, beginning on page 79. 


Viewing SMIL Source Mark-Up 


RealPlayer 7 has a View>Clip Source command that shows the SMIL mark-up 
of the presentation currently playing. The RealServer or Web server hosting 
the presentation sends the mark-up as an HTML page that opens in your 
default Web browser. This feature lets you examine SMIL presentations to 
learn how they are laid out and timed. 


SMIL source information is denied for secure presentations that require a user 
name and password. The RealServer administrator may also disallow access to 
the SMIL file source, or allow access to the source but conceal the full paths of 
clips. When access is allowed, the Web page showing the SMIL syntax includes 
a hypertext link for each clip in the presentation. Clicking a link takes you to a 
new Web page with information about a clip, including its size, buffer time, 
and streaming bit rate. 


Smoothing Transitions between Clips 


By grouping clips played in sequence within a SMIL <par> tag, you can create 
smooth transitions between the clips. When clips normally play in sequence, 
each clip buffers data (its preroll) when it starts to play. By grouping the 
sequence within a <par> tag, though, RealSystem takes advantage of unused 
bandwidth to send clips’ preroll before they start to playback. You can use this 
feature to mask preroll for high-bandwidth clips, for example, by streaming 
the preroll while low-bandwidth, introductory clips play. 
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The following SMIL example, which omits the header that defines the region 
layout and base URL, shows how to mask preroll for high-bandwidth clips and 
create smooth transitions between the initial and subsequent clips: 
<body> 
<par> 
<seq> 
<par> 
<!-- group 1: introductory group masking preroll --> 
<audio src="intro.rm” /> 
<textstream src="titles.rt” region="left”/> 
<textstream src="credits.rt” region="right”/> 
</par> 
<par> 
<!-- group 2: main group with masked preroll --> 
<ref src="graphics.rp” region="left”/> 
<video src="story.rm” region="right”/> 
</par> 
</seq> 
</par> 
</body> 
Group 1 consists of two RealText clips and a RealAudio clip played in parallel. 
Because of the <seq> tag, the group 1 clips precede the RealPix and RealVideo 
clips in group 2. If the <seq> tag were the highest level of organization, 
RealServer would stream the group 1 clips without regard to group 2, 
streaming data for group 2 clips only after group 1 finished. Viewers would 
experience a delay after group 1 clips finished as RealServer streamed preroll 
for group 2 clips. 


The outer <par> tag just below the <body> tag, however, makes RealSystem 
treat groups 1 and 2 as one large parallel group with subgroups played in 
sequence. Although this doesn’t affect the order in which the clips play, the 
parallel grouping makes RealSystem balance bandwidth between all clips. 
After it starts to stream the group 1 clips, RealServer makes use of unused 
bandwidth by streaming data for group 2 clips while the group 1 clips play. 
This masks the preroll for the group 2 clips. 


Note 
When you enclose clips in a <par> group, the individual 
clips do not appear in the RealPlayer playlist. 
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Additional Information 
See “What is Preroll?” on page 32 and “Developing 
Multiclip Presentations” on page 37. 


Hiding Regions with z-index 


RealPlayer creates all regions defined in a SMIL file’s header section when it 
first reads the file. So a single SMIL presentation cannot play clips in a certain 
set of regions, then destroy those regions and create different regions with a 
new layout. To accomplish dynamic layout changes, you can create separate 
SMIL files that define each region set, then play the SMIL files in sequence as 
described in “Creating a Ram File Manually” on page 165. 


An alternative is to create a single SMIL file that uses the <region> tag’s z-index 
parameter to create transparent, overlaying regions. The following SMIL 
header example creates a left region next to a right region. Both are in portrait 
orientation, their heights over twice the value of their widths. A second set of 
regions, top and bottom, are stacked. These regions have higher z-index values, 
meaning that they display in front of the left and right regions: 
<head> 
<layout> 
<root-layout width="360” height="360"/> 
<!-- first two side-by-side regions --> 
<region id="left” top="10" left="10" width="165" height="340" z-index="0"/> 
<region id="right” top="10" left="185" width="165”" height="340" z-index="1" /> 
<!-- second two stacked regions --> 
<region id="top” top="10" left="70" width="220" height="165” z-index="2"/> 
<region id="bottom” top="185”" left="70" width="220" height="165” z-index="3” /> 
</layout> 
</head> 


As defined in the following SMIL body, RealPix and RealText clips first play in 
the left and right regions, which appear beneath the top and bottom regions. 
Because the overlaying top and bottom regions do not use background colors, 
they remain transparent until clips play in them. The introductory RealPix 
and RealText clips disappear when they finish playback, restoring to view the 
root-layout default background color of black. The group 2 clips, a RealVideo 
clip and another RealText clip, then play in the top and bottom regions: 
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<body> 
<par> 
<seq> 
<par> 
<!-- group 1: side-by-side titles and credits --> 
<ref src="titles.rp” region="left” fill=”remove”/> 
<textstream src="credits.rt” region="right” fill=”remove”/> 
</par> 
<par> 
<!-- group 2: stacked video and subtitles --> 
<video src="story.rm” region="top” /> 
<textstream src="subtitles.rt” region=”" bottom” /> 
</par> 
</seq> 
</par> 
</body> 


Although the left, right, top, and bottom regions exist from the start of the 
SMIL file playback, the use of z-index, fill="remove”, and default region 
transparency makes it appear as if the regions are created dynamically with 
each new set of clips. The following figure illustrates the initial region 


creation, the first set of clips, then the second set of clips playing in the 
RealPlayer window. 


Transparent Region Creation and Ordering 


Regions Titles Credits Subtitles 





Additional Information 
For more on z-index, see “Ordering Overlapping Regions 
with z-index” on page 105. “Laying Out Multiple Clips” 
on page 99 discusses SMIL layouts. 
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Writing Complex SMIL Switch Statements 


The SMIL <switch> tag is a powerful feature that lets you specify options that 
each RealPlayer can choose between based on its preference settings and 
available bandwidth. “Switching Between Alternate Choices” on page 93 
explains the basics of using the <switch> tag. The following sections give tips 
on writing complex <switch> statements. 


Switching with SureStream Clips 


With RealAudio or RealVideo clips encoded for multiple bit rates with 
SureStream technology, you may or may not need to use the <switch> tag: 


- When the presentation consists solely of a SureStream clip, simply link to 
that clip within the SMIL file. The clip then streams at the rate 
appropriate for RealPlayer’s connection speed. You do not need to specify 
bandwidth choices with a <switch> group. 


Use the <switch> tag when combining a SureStream clip with other clips 
encoded for single bandwidths. The SureStream clip is always used, but 
the <switch> group gives RealPlayer options for other clips. The following 
example illustrates a RealAudio SureStream clip and a choice between two 
RealPix presentations built for different bandwidths: 
<par> 
<audio src="audio/newsong2.rm”/> 
<switch> 
<ref src="image/slideshow1.rp” system-bitrate="47000" /> 
<ref src="image/slideshow2.rp” system-bitrate="20000”" /> 
</switch> 
</par> 


Additional Information 
For more on SureStream, see “Choosing RealAudio 
Codecs” on page 49 and “Choosing RealVideo Codecs” 
on page 61. Refer to “Supporting Multiple Bandwidth 
Connections” on page 39 for more on developing 
presentations for different connection speeds. 


Switching with Multiple Test Attributes 


You can use multiple <switch> test attributes to have RealPlayer choose clips 
based on both bandwidth and language. There are two ways to do this. In this 





199 


APPENDIX C: Advanced Production Techniques RealSystem G2 Production Guide 





first example, each audio clip choice has two test-attributes, one for language 
and one for bandwidth. Both attributes must be viable for RealPlayer to 
choose the clip: 


<switch> 
<!-- French language choices --> 
<audio src="sound/audio_fr2.rm” system-language="fr” system-bitrate="47000"/> 
<audio src="sound/audio_fri.rm” system-language="fr” system-bitrate="20000"/> 
<!-- English language choices (default) --> 
<audio src="sound/audio_en2.rm” system-bitrate="47000" /> 
<audio src="sound/audio_en1.rm” system-bitrate="20000"/> 

</switch> 


Because RealPlayer evaluates the <switch> choices from top to bottom, 
selecting the first viable option, the last two choices do not have system- 
language options. This lets all RealPlayers other than those with French as 
their language preference choose between the two English-language clips. 


The next example adds RealText clips in both French and English to the 
presentation possibilities. Here, <switch> statements are nested so that 
RealPlayers with French set as their language preference play the French 
RealText clip and choose from the set of French-language RealAudio clips 
based on available bandwidth. All other RealPlayers play the English RealText 
clip and choose from a set of English-language RealAudio clip: 


<switch> 
<!-- Choose French as the language --> 
<par system-language="fr’> 
<textstream src="text/credits_fr.rt”/> 
<switch> 
<!-- Choose fast or slow bit rate for French audio --> 
<audio src="sound/audio_fr2.rm” system-bitrate="47000"/> 
<audio src="sound/audio_fri.rm” system-bitrate="20000"/> 
</switch> 
</par> 
<!-- Choose English (default) as the language --> 
<par> 
<textstream src="text/credits_en.rt” /> 
<switch> 
<!-- Choose fast or slow bit rate for English audio --> 
<audio src="sound/audio_en2.rm” system-bitrate="47000"/> 
<audio src="sound/audio_eni.rm” system-bitrate="20000"/> 
</switch> 
</par> 
</switch> 
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Switching Presentations for Different RealPlayer Versions 


Different versions of RealPlayer may have different features that affect which 
presentations they can play. RealPlayer G2 cannot use the caching and 
multiple window features of RealPlayer 7, for example. However, you can create 
different clips for different RealPlayer versions, then use a SMIL <switch> tag 
to let each RealPlayer choose the correct clips to play. 


A <switch> tag can test for any number of RealPlayer versions in order from 
newest to oldest. It uses a system-required test attribute to specify which 
version of RealPlayer can play each choice. The last choice, which is meant for 
the oldest RealPlayers you’re considering, does not have a system-required 
attribute. A SMIL file with this type of <switch> tag uses this general form: 


<smil xmlns:cv="http://features.real.com/systemComponent”> 
<body> 
<switch> 
<seq system-required="cv” cv:systemComponent=”...attribute to test...”> 
...clips to play if RealPlayer satisfies the first test attribute... 
</seq> 
<seq system-required="cv” cv:systemComponent=”...attribute to test...”> 
...clips to play if RealPlayer satisfies the second test attribute... 
</seq> 
<seq> 
...clips to play for the default choice, which has no test attribute... 
</seq> 
</switch> 
</body> 
</smil> 


The sample <switch> tag above lets RealPlayer choose between three <seq> 
groups, though RealPlayer could also choose between <par> groups or 
individual clips. The final, default choice must always be included and must 
not use the system-required test attribute. 
Tip 
You'll need a separate computer for each version of 


RealPlayer you’re testing. Multiple versions of 
RealPlayer cannot reside on the same machine. 


> To write a <switch> tag to test for different versions of RealPlayer: 


1. Declare the XML namespace in the <smil> tag. 
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Although RealPlayer’s implementation of SMIL does not typically need a 
XML namespace declaration, the use of systemComponent as a test attribute 
requires the following declaration: 


<smil xmlns:cv="http://features.real.com/systemComponent”> 


The namespace must be declared exactly as shown above. This declaration 
informs RealPlayer that the SMIL file uses the XML extension 
systemComponent. The declaration has the following components: 


xmlns: Indicates an XML namespace declaration. 


CV= Namespace name defined by RealNetworks. The “cv” stands for 
“component version.” 


“http://...” The quoted URL “http://features.real.com/systemComponent” is 
used by RealPlayer solely as an identifier that uniquely defines the 
namespace. RealPlayer does not contact this URL. The URL is valid, 
however, and displays an HTML page that describes the feature. 


2. Write a <switch> tag with the proper system-required and systemComponent 
syntax. Within the <switch> tag, you include a system-required test 
attribute that has this form: 
system-required="cv” 
cv:systemComponent="http://features.real.com/?feature;player=6.0.7.x” 


The components of the test attribute are as follows: 

system-required=“cv” Refers to the “component version” namespace defined in 
the <smil> tag. 

cv:systemComponent= Defines a new feature test attribute. Case must be exact. 


“http://..." The quoted URL “http://features.real.com?feature;” is 
the unique identifier for the component syntax. It 
matches the URL in the <smil> tag namespace 
declaration. RealPlayer does not request this URL. 


player= Specifies that systemComponent checks for a RealPlayer 
feature. 
6.0.7.x Indicates version of RealPlayer to check for, such as 


6.0.7.362. All RealPlayers with the given version number 
or higher choose this test attribute. You can find a 
RealPlayer’s version number with the About RealPlayer 
command under the Help or Apple menu. 


Note 
The RealPlayer version, such as 6.0.7.362, is the only 
part of the systemComponent syntax you should change. 
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Example 1: Caching Files for RealPlayer 7 but not RealPlayer G2 


As explained in “Caching Images Files” on page 125, RealPlayer 7 can cache 
downloaded image files, but RealPlayer G2 cannot. The following example is a 
SMIL <switch> tag that causes RealPlayer 7 to download and cache two logo 
files. If RealPlayer G2 requests this SMIL file, it simply downloads the logo 
files. This extract revises the SMIL file described in “Authoring SMIL Files for 
Caching” on page 128. 


<smil xmlns:cv="http://features.real.com/systemComponent”> 
<body> 


<switch> 
<seq system-required="cv” 
cv:systemComponent="http://features.real.com/?feature;player=6.0.7.362”"> 
<!-- For RealPlayer 7, download and cache these two logos” --> 
<img src="chttp://www.company.com/images/logo1.gif?bitrate=20000” 
region="logo1” fill="freeze”/> 
<img src="chttp://www.company.com/images/logo2.gif?bitrate=20000” 
region="logo2” fill="freeze”/> 
</seq> 
<seq> 
<!-- For RealPlayer G2, download these two logos” --> 
<img src="http://www.company.com/images/logo1.gif?bitrate=20000” 
region="logo1” fill="freeze”/> 
<img src="http://www.company.com/images/logo2.gif?bitrate=20000” 
region="logo2” fill="freeze” /> 
</seq> 
</switch> 
</body> 
</smil> 


When evaluating this <switch> statement, RealPlayer 7 chooses the first <seq> 
group. For the actual version number, shown above as 6.0.7.362, use the 
version number from your RealPlayer7. RealPlayer G2 ignores the first <seq> 
group and chooses the second <seq> group, which has no test attribute. 


Example 2: Launching Multiple Windows for RealPlayer 7 but not RealPlayer G2 


“Popping Up New RealPlayer Windows” on page 121 explains how RealPlayer 
7 can launch presentations in new windows. RealPlayer G2 uses only one 
window, however. The following SMIL <switch> tag presents RealPlayer with a 
choice between two RealText files. The first RealText file has hyperlinks that 
launch clips in new RealPlayer windows. The second RealText file, written for 
RealPlayer G2, plays clips in the main RealPlayer window: 
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<smil xmlns:cv="http://features.real.com/systemComponent”> 
<body> 


<switch> 
<!-- RealText clip to play with RealPlayer 7. --> 
<textstream system-required="cv” cv:systemComponent= 
"http://features.real.com/?feature;player=6.0.7.362” 
src="rtsp://realserver.company.com/realtext/navigateRP7.rt 
region="text” fill="freeze” /> 
<!-- RealText clip to play with RealPlayer G2. --> 
<textstream 
src="rtsp://realserver.company.com/realtext/navigateG2.rt 
region="text” fill="freeze” /> 
</switch> 
</body> 
</smil> 


Displaying Captions for the Hearing Impaired 


The RealPlayer preferences window has an option to enable captions for the 
hearing impaired. To author these captions, write a RealText clip that 
coordinates text with the audio timeline. Then create a SMIL file that plays 
the two in parallel. The SMIL attribute system-captions="on” makes the 
captions appear only if the viewer’s preferences enable captions: 
<smil> 
<head> 
<layout> 
<root-layout background-color="blue” width="310” height="200"/> 
<region id="video” width="176” height="132” left="67” top="5”" /> 
<region id="captions” width="300" height="50” left="4”" top="145"/> 
</layout> 
</head> 
<body> 
<par> 
<video src="news.rm” region="video” /> 
<textstream src="captions.rt” region="captions” system-captions="on” /> 
</par> 
</body> 
</smil> 


In this example, the RealText clip (captions.rt) appears only for viewers who 
have enabled captions in RealPlayer. For all other viewers, the caption region 
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shows the root-layout region’s background color. RealPlayer’s captions setting 
does not affect the video clip, which has no system-captions value. Following 
sections explain how to fill the caption region or make it disappear when 
captions are off. 


Tip 
The system-captions attribute also works for <seq> and 
<par> groups. You can use system-captions=“off” to make 
a clip or group play only when system captions are 
turned off in RealPlayer. 


Additional Information 
“Laying Out Multiple Clips” on page 99 discusses SMIL 
layouts. RealText Authoring Guide is available at 
hetp://service.real.com/help/library/encoders.html. 
The RealPlayer online help can assist you with turning 
captions on and off in the preferences. 


Filling a Captions Region when Captions are Off 


To avoid a blank region when captions are off, you can display another file, 
such as an image file, in the caption region. The following extract is from a 
SMIL file that uses the same layout as the previous example. Here, the parallel 
group includes an image clip with a system-captions="off” attribute. This 
makes the image display only when captions are turned off in RealPlayer: 
<par> 

<video src="news.rm” region="video” /> 

<textstream src="captions.rt” region="captions” system-captions="on"/> 

<img src="filler.gif” region="captions” system-captions="off” /> 
</par> 


Any clip, not just a static image, can fill the captions region when captions are 
off. The filler clip should be the same size as the RealText captions clip, 
however, when the two display in the same region. 


Resizing the Playback Area for Captions 


As an extension to SMIL, RealPlayer supports system-captions in layout tags. 
This lets you change layouts when captions are displayed. The following SMIL 
file centers a video region above a captions region only when RealPlayer 
enables captions. Although this example uses system-captions in the <layout> 
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tag, you could use the attribute in <root-layout/> and <region/> tags as well to 
display or hide individual regions based on RealPlayer’s captions setting: 


<smil> 
<head> 
<meta name="title" content="Closed-Captioned News"/> 
<!-- Layout used when captions are on. --> 
<layout system-captions="on"> 
<root-layout background-color="blue” width="310” height="200”/> 
<region id="video” width="176” height="132” left="67” top="5" /> 
<region id="captions” width="300" height="50” left="4” top="145"/> 
</layout> 
</head> 
<body> 
<par> 
<video src="news.rm” system-captions=" off” /> 
<video src="news.rm” region="video” system-captions="on” /> 
<textstream src="captions.rt” region="captions” system-captions="on” /> 
</par> 
</body> 
</smil> 


With this SMIL file, RealPlayer creates the layout and plays the RealText clip 
in parallel with the video only when captions are on. When captions are off, 
RealPlayer defines no regions and plays only the news.rm clip that includes the 
system-captions=“off” attribute. When captions are off, the SMIL file is 
equivalent to the following: 
<smil> 
<head> 
<meta name="title" content="Closed-Captioned News"/> 
</head> 
<body> 
<video src="news.rm” system-captions=" off” /> 
</body> 
</smil> 
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Once you understand SMIL, use this appendix as reference when 
writing SMIL files. For full information on SMIL and RealSystem, 
see Chapter 7 beginning on page 79. In the tables below, an asterisk 
(*) denotes a required attribute. Ellipses (...) designate nonessential 


information left out of the example. 


Header Tags 


<meta.../> 


The header region’s <meta.../> tags provide presentation information. A 
<meta.../> tag can also set a base URL for source clips in the SMIL file. 


<meta.../> Tag Attributes 




















Attribute Value Function Reference 

content * | any value Provides content for the name attribute. | page 95 
abstract Gives presentation abstract. page 95 
author Lists name of presentation author. page 95 

Pre base Sets base URL for source clips. page 83 
copyright Supplies presentation copyright. page 95 
title Gives presentation title, which displays | page 95 

in the RealPlayer run list. 














Note 
You can define other information attributes besides 
abstract, author, copyright, and title. See “Adding 
Presentation Information” on page 95. 
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Examples 

<meta name="author” content="Jane Morales” /> 

<meta name="title” content="Multimedia My Way”/> 

<meta name="copyright” content="(c)1998 Jane Morales” /> 
<meta name="base” content="rtsp://realserver.example.com/"/> 


<layout>...</layout> 


The <layout> and </layout> tags define the layout of visual clips such as video 
and animation. Within the tags, you define a root-layout region and separate 
regions for the clips. The layout must be defined with the SMIL header. 


<root-layout.../> 


Within <layout>...</layout>, <root-layout> sets the overall size of the playback 
area. Clips do not play in the root-layout area. 


<root-layout.../> Tag Attributes 


























Attribute Value Function Reference 
background-color | color name | Sets root-layout color. page 103 
or hex value 
height * pixels Sets playback area height. page 100 
system-captions | onloff Determines if root-layout is created | page 205 
based on system captions preference. 

width * pixels Sets playback area width. page 100 
Example 
<layout> 


<root-layout background-color="maroon” width="250” height=”"230"/> 
<region .../> 
<region .../> 

</layout> 
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<region.../> 


Within <layout>...</layout>, <region> tags define the size and placement 
(relative to root-layout) of each region used to play clips. 


<region.../> Tag Attributes 














Attribute Value Function Reference 

background-color | color name or | Sets region background color. page 103 
hex value 

fit fill, hidden, Determines how clip fits region when | page 104 
meet, or slice | the two are different sizes. 

height * pixels or Sets region height. page 100 
percentage 

id * name Provides target name for setting clips | page 101 


to play in the region. 





























left * pixels or Sets region offset from the left side of | page 100 
percentage the root-layout region. 

system-captions |onloff Determines if region is created based | page 205 

on system captions preference. 

top * pixels or Sets region offset from the top of the | page 100 
percentage root-layout region. 

width * pixels or Sets region width. page 100 
percentage 

z-index number Defines order of overlapping regions. | page 105 

Example 

<layout> 


<root-layout .../> 
<region id="video” top="5" left="5" width="240”" height="180” 
background-color="blue” fit="fill” z-index="3"/> 
<region.../> 
</layout> 


Clip Source Tags 


To define locations and timing attributes for clips within a presentation, use 
one of the following source tag: 
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<animation.../> 
<audio.../> 
<img.../> 
<ref.../> 
<text.../> 
<textstream.../> 
<video.../> 
<RealAdInsert.../> 


Except for <RealAdInsert.../>, the choice of tag does not affect playback. All clip 
source tags can use <ref.../>, for example. The <RealAdInsert.../> tag is not a 
SMIL tag, but a RealSystem tag that RealServer replaces with a SMIL tag for 
an advertising clip. It does not include a src attribute, but can include any 
other SMIL clip attribute. These attributes get passed to the replacement tag. 
See Chapter 10 beginning on page 149 for more on <RealAdInsert.../>. 


Clip Source Tag Attributes 
































Attribute Value Function Reference 

abstract abstract Gives abstract for clip. page 96 

author name Lists author for clip. page 96 

begin h, min, s, or ms | Delays normal playback time. page 89 

clip-begin h, min, s, or ms | Specifies clip’s internal timing mark | page 90 
where playback begins. 

clip-end h, min, s, or ms | Specifies clip’s internal timing mark | page 90 
where playback ends. 

copyright copyright Lists copyright information for clip. | page 96 

dur h, min, s, or ms | Sets total time clip plays. Do not use| page 91 
with end. 

end h, min, s, or ms | Sets end time for clip relative to begin | page 89 
time. Do not use with dur. 

fill freeze or Freezes or removes (default) clip from | page 92 

remove screen when it stops playing. 
id name Names clip for reference by other page 86 


SMIL elements. 





region <region.../> Assigns clip to a region. page 107 
tag id name 





repeat number Repeats clip the specified number of 

times. 

src * URL Provides full or relative URL for clip. | page 81 
(Table Page 1 of 2) 


page 87 
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Clip Source Tag Attributes (continued) 























Attribute Value Function Reference 

system-bitrate | bits per second | Sets bit rate attribute for page 94 
<switch>...</switch>. 

system-captions | onloff Determines if clip plays based on page 204 
system captions preference. 

system-language | language code | Sets language attribute for page 94 
<switch>...</switch>. 

title title Lists title for clip. page 96 

(Table Page 2 of 2) 
Examples 


<video src="rtsp://realserver.example.com/media/video2.rm” region="video” 
begin="40s” clip-begin="5100ms” clip-end="4.5min” fill="freeze”/> 


<audio src="rtsp://realserver.example.com/media/music.rm” 
dur="10.5s" repeat="5"/> 


Image Source Tag Options 


For a still image, you can include the following options in the image source 


tag. Note that these options are extensions to SMIL that work only with 





























RealPlayer. 
Image Source Tag Options 

Option Value Function Reference 

bgcolor | color name or hex Changes GIF transparency to color. page 119 
value 

bitrate | bits per second (bps) | Sets streaming bit rate. page 118 

reliable | true Guarantees reliable image transmission. | page 120 
_ browser Makes Web browser the URL target. page 119 

or _player Sets RealPlayer as command target. page 119 
URL Sends URL to browser on mouse click. | page 119 
command:play() Gives play command on mouse click. 
command:pause() Gives pause command on mouse click. 

url command:seek(time) | Makes RealPlayer seek to specified time page 119 


in timeline on mouse click. Time has 
dd:hh:mm:ss.xyz format. 








command:stop() 





Gives stop command on mouse click. 
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A question mark operator (“?”) separates image options from the image URL 
in the clip source tag. Additional options preceded by ampersands (“&”) can 
follow in this format: 


<img src= “URL? option=value&option=value” /> 


Note 
Image options and values are not in quotation marks 
because they are part of the quoted src value. 


Examples 
<img src="ad1.gif?bitrate=1000&bgcolor=blue” /> 


<img src="ad.gif?url=http://www.example.com&target=_browser” .../> 
<img src="stop.gif?url=command:stop()&target=_player” .../> 


<img src="seek.gif?url=command:seek(1:35.4)&target=_player” .../> 


Group Tags 


<par>...</par> 


The <par> and </par> tags make enclosed clips play in parallel. No attributes 
are required for a <par> tag. 


<par> Tag Attributes 
































Attribute Value Function Reference 
abstract abstract Gives abstract for group. page 96 
author name Lists author for group. page 96 
begin h, min, s, or ms | Delays normal group playback time. | page 90 
copyright copyright Lists copyright for group. page 96 
dur h, min, s, or ms | Sets total time group plays. page 91 
end h, min, s, or ms | Sets end time for group relative to page 90 
begin time. Do not use with endsync. 
first Ends group when first clip ends. 
endsync last Ends group when last clip ends. page 86 
id(clip id) Ends group when specified clip ends. 
id name Names group for reference by other page 113 
SMIL elements. 
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<par> Tag Attributes (continued) 


























Attribute Value Function Reference 

repeat number Repeats group the specified number page 87 
of times. 

system-bitrate | bits per second | Sets bit rate attribute for page 94 
<switch>...</switch>. 

system-captions | onloff Determines if group plays based on page 204 
system captions preference. 

system-language | language code | Sets language attribute for page 94 
<switch>...</switch>. 

title title Lists title for group. page 96 

(Table Page 2 of 2) 
Examples 
<par> 


<video src="videos/newsong.rm” /> 
<textstream src="lyrics/newsong.rt”/> 


</par> 


<par endsync=“id(text)” repeat="2”" begin="4s"> 
<video src="videos/newsong.rm” /> 
<textstream id="text” src="Llyrics/newsong.rt”/> 


</par> 


<seq>...</seq> 


The <seq> and </seq> tags group clips that play in sequence. No attributes are 


required for a <seq> tag. 





<seq> Tag Attributes 














Attribute Value Function Reference 

begin h,min,s,orms | Delays normal group playback time. | page 90 

dur h,min,s,orms_ | Sets total time group plays. page 91 

end h, min, s,orms | Sets end time for group relative to page 90 
begin time. 

id name Names group for reference by other | page 113 
SMIL elements. 

repeat number Repeats group the specified number page 87 





of times. 
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<seq> Tag Attributes (continued) 


Attribute Value Function Reference 





system-bitrate | bits per second | Sets bit rate attribute for page 94 
<switch>...</switch>. 





system-captions | onloff Determines if group plays based on | page 204 
system captions preference. 





system-language | language code __| Sets language attribute for page 94 
<switch>...</switch>. 
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Example 
<seq repeat="3"> 
<audio src="rtsp://realserver.example.com/one.rm” /> 
<audio src="rtsp://realserver.example.com/two.rm” /> 
</seq> 


<switch>...</switch> 


The <switch> and </switch> tags contain clips or groups of clips that 
RealPlayer chooses between based on its available bandwidth or language 
preference. Clips or groups that RealPlayer evaluates must include a system- 
bitrate or system-language attribute. 


<switch> Tag Attributes 


Attribute Value Function Reference 


id Names group as a link target for other SMIL files. | page 113 


Additional Information 
See “Switching Between Alternate Choices” on page 93. 


Example 

<switch> 
<audio src="french/seattle.rm” system-language="fr" /> 
<audio src="german/seattle.rm” system-language="de" /> 
<audio src="english/seattle.rm”/> 

</switch> 
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Hyperlink Tags 


<a>...</a> 


The <a>...</a> tags work like HTML hyperlink tags to connect a media source 


clip to another clip. But whereas you enclose text between <a> and </a> in 
HTML, you enclose a media source tag between <a> and </a> in SMIL. 





<a.../> Tag Attributes 























Attribute Value Function Reference 
href * URL Sets hyperlink URL. page 109 
new Opens URL in browser while RealPlayer continues. 
Sine, pause Opens URL in browser and pauses RealPlayer. page 109 
replace | Opens URL in RealPlayer. 
(default) 
Example 


<a href="http://www.example.com/index.htm” show="new”> 
<video src="video.rm” region="videoregion”/> 


</a> 


<anchor.../> 


An <anchor> tag can define a hot spot hyperlink that can be temporal as well as 
spatial. It fits within a media source tag: 


<video ... 


> 


<anchor .../> 


</video> 


Note that here the <video> source tag does not end with a forward slash as it 


normally does. Instead, a </video> tag follows it and the <anchor.../> tag. 





<anchor.../> Tag Attributes 








Attribute Value Function Reference 

begin h, min, s, or ms | Defines when hot spot becomes active or when | page 113 

linked media clip begins in its timeline. page 115 

coords | pixels or Defines boundary for hot spot as left, top, page 111 
percentages right, and bottom offset from source clip. 

end h, min, s, or ms | Determines when hot spot deactivates. page 113 
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<anchor.../> Tag Attributes (continued) 

















Attribute Value Function Reference 
href * URL Sets hyperlink URL. page 111 
id name Defines target for use by other hypertext links. | page 115 
new Opens URL in browser while RealPlayer 
continues playback. 
show pause Opens URL in browser and pauses RealPlayer. | page 109 
replace Opens URL in RealPlayer. 
(default) 
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Examples 
<video src="video.rm” region="videoregion”> 
<anchor href="rtsp://realserver.example.com/vid2.rm” coords="20,40,80,120"/> 
</video> 
<video src="video.rm” region="videoregion”> 
<anchor href="http://www.example.com” show="pause” coords="10,30,70,100” 
begin="5s" end="45s"/> 
</video> 


Pop-Up Window Commands 


In a SMIL hyperlink, you can include a command:openwindow argument with 
the following options to open the link target in a new RealPlayer window. 
These extensions to SMIL work only with RealPlayer 7 and higher. 


Pop-Up Window Attributes 





























Attribute Value Function Reference 
_new ; ; 
Opens URL in a new RealPlayer window. 
_blank 
.  |—self ; ; 
(name) Opens URL in the current window. page 122 
_current 
name Opens URL in a new RealPlayer window that has 
the given name. 
(URL) * URL Provides URL for the new clip or presentation. | page 122 
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Pop-Up Window Attributes (continued) 








Attribute Value Function Reference 
. true Puts new window in autosize mode. 
autosize - - 
false Opens new window in compact mode. (Default) 





normal Plays clip at its normal size. (Default) 























zoomlevel | double Doubles clip size. page 122 
full Plays clip at full-screen. 

ontopwhile | true Keeps new window on top of other windows. 

playing false Lets user control window placement. (Default) 


(Table Page 2 of 2) 


The syntax for a pop-up window in the <a> or <anchor> tag looks like the 
following, with name and URL coming first and second as single statements 
rather than as attribute=value pairs: 


<a href=“command:openwindow(name, URL, playmode=value, ...)">...</a> 


Examples 
<a href="command:openwindow(_new, rtsp://realserver.example.com/animals.rm, 
autosize=true, ontopwhileplaying=true)”> 
<img src="launch_button.gif” region="button”/> 
</a> 


<video src="rtsp://realserver.example.com/video/video1l.rm” region="video”> 
<anchor href=“command:openwindow(popup, 
rtsp://realserver.example.com/video/video2.rm, zoomlevel=double)” 
coords="0,0,25%,25%"/> 
</video> 





217 


Ad, 






FILE TYPE REFERENCE 


The following tables provide a quick reference to file types commonly used in 
RealSystem media production. This is not a definitive list of all file types used in 
RealSystem, however. Plug-in technology allows RealSystem to stream virtually any 


file type. 
Additional Information 


Refer to http://www.realnetworks.com/devzone for information 
on other types of media RealSystem can stream. 


RealSystem Standard Streaming Clip Types 




















Extension File Type Reference 

.rm or .ra | RealAudio “Creating RealAudio Clips” on page 48 
rm RealVideo “Creating RealVideo Clips” on page 61 
rp RealPix streaming image mark-up “Images” on page 16 

.rpa RealPix ad rotation “Displaying Banner Ads” on page 150 
wrt RealText streaming text “Text” on page 17 

swf Shockwave Flash file “Producing Animation” on page 67 











RealSystem Information Files 











Extension File Type Reference 
ram Ram file to launch RealPlayer ; ; 
: ; “Creating a Ram File Manually” on page 165 
pm Ram file for embedded presentations 
.smil, .smi | SMIL file for layout and timing “SMIL General Rules” on page 80 
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Video File Types Encodable as RealVideo 
Extension File Type Reference 


avi Windows standard video 





—— - “Creating RealVideo Clips” on page 61 
.-mov QuickTime movie 


Common Video File Types Streamed by RealSystem 






































Extension File Type Reference 
asf Advanced Streaming Format 
.avi Windows standard video ; ; 
—— - “Streaming Other Video Formats” on page 65 
-mov QuickTime movie 
.ViV Vivo video 
Audio File Types Encodable as RealAudio 
Extension File Type Reference 
.aif Audio Interchange Format 
au Sun standard audio 
.mov QuickTime movie “Creating RealAudio Clips” on page 48 
snd Sound audio 
.wav WAV audio 











Common Audio File Types Streamed by RealSystem 











Extension File Type Reference 

.aif Audio Interchange Format 

.au Sun-standard audio “Streaming Other Audio Formats” on page 53 
-wav WAV audio 
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Image Files Types Playable Directly in RealPlayer and RealPix 











Extension File Type Reference 

gif GIF87, GIF89, or animated GIF image 

-jJpg JPEG (nonprogressive ) image “Images” on page 16 
.png PNG image 
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SMIL LANGUAGE CODES 


As “Setting Language Choices” on page 94 explains, SMIL can list different 






y 


fo 


language choices that RealPlayer chooses from based on its language preference. 


The following table lists the codes you can use in a SMIL file to indicate clips 


created for specific languages. 























































































































Code Language 

af Afrikaans 

sq Albanian 

ar-iq Arabic ( Iraq) 
ar-dz Arabic (Algeria) 
ar-bh Arabic (Bahrain) 
ar-eg Arabic (Egypt) 
ar-jo Arabic (Jordan) 
ar-kw Arabic (Kuwait) 
ar-lb Arabic (Lebanon) 
ar-ly Arabic (Libya) 
ar-ma Arabic (Morocco) 
ar-om Arabic (Oman) 
ar-qa Arabic (Qatar) 
ar-sa Arabic (Saudi Arabia) 
ar-sy Arabic (Syria) 
ar-tn Arabic (Tunisia) 
ar-ae Arabic (U.A.E.) 
ar-ye Arabic (Yemen) 
eu Basque 

bg Bulgarian 

ca Catalan 








Code Language 

zh-hk Chinese (Hong Kong) 
zh-cn Chinese (People’s Republic) 
zh-sg Chinese (Singapore) 
zh-tw Chinese (Taiwan) 

hr Croatian 

cs Czech 

da Danish 

nl Dutch (Standard) 
nl-be Dutch (Belgian) 

en English 

en-au English (Australian) 
en-bz English (Belize) 

en-gb English (British) 
en-ca English (Canadian) 

en English (Caribbean) 
en-ie English (Ireland) 
en-jm English (Jamaica) 
en-nz English (New Zealand) 
en-za English (South Africa) 
en-tt English (Trinidad) 
en-us English (United States) 
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Code Language Code Language 

et Estonian sl Slovenian 

fo Faeroese es-ar Spanish (Argentina) 
fi Finnish es-bo Spanish (Bolivia) 
fr-be French (Belgian) es-cl Spanish (Chile) 

fr-ca French (Canadian) es-co Spanish (Colombia) 
fr-lu French (Luxembourg) es-cr Spanish (Costa Rica) 
fr French (Standard) es-do Spanish (Dominican Republic) 
fr-ch French (Swiss) es-ec Spanish (Ecuador) 
de-at German (Austrian) es-sv Spanish (El Salvador) 
de-li German (Liechtenstein) es-gt Spanish (Guatemala) 
de-lu German (Luxembourg) es-hn Spanish (Honduras) 
de German (Standard) es-mx Spanish (Mexican) 
de-ch German (Swiss) es-ni Spanish (Nicaragua) 
el Greek es-pa Spanish (Panama) 
he Hebrew es-py Spanish (Paraguay) 
hu Hungarian es-pe Spanish (Peru) 

is Icelandic es-pr Spanish (Puerto Rico) 
in Indonesian es Spanish (Spain) 

it Italian (Standard) es-uy Spanish (Uruguay) 
it-ch Italian (Swiss) es-ve Spanish (Venezuela) 
ja Japanese sv Swedish 

ko Korean sv-fi Swedish (Finland) 

ko Korean (Johab) th Thai 

lv Latvian tr Turkish 

lt Lithuanian uk Ukrainian 

no Norwegian vi Vietnamese 

pl Polish 

pt-br Portuguese (Brazilian) 

pt Portuguese (Standard) 

ro Romanian 

sr Serbian 

sk Slovak 
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Advertising Application 
A RealSystem option that inserts ads 
into SMIL-based presentations. The 
SMIL files use <RealAdInsert/> tags to 
indicate ad placement. 


bandwidth 
The upper limit on the amount of 
data, typically expressed as Kilobits 
per second (Kbps), that can pass 
through a network connection. 


banner ad 
An ad that appears alongside a 
requested clip or presentation. A 
banner ad can also rotate, making 
new ad images appear at regular 
intervals. 

bit 
The smallest unit of measure of data 
in a computer. A bit has a binary 


value, either 0 or 1. 


bit rate 
A measure of bandwidth, expressed as 
the number of bits transmitted per 
second. A 28.8 Kbps modem, for 
example, can transmit or receive 


around 29,000 bits per second. 


broadcast 
To deliver a presentation, whether live 
or prerecorded, in which all viewers 


join the presentation in progress. 


buffering 
Receiving and storing data before 
playing it back. The initial buffering 
time is called preroll. After preroll, 
excessive buffering may stall the 
presentation. 

byte 
A common measurement of data. 


One byte comprises eight (8) bits. 


CHTTP 
A version of HTTP supported by 
RealPlayer. Resources designated with 
chttp:// are downloaded through 
HTTP and stored in RealPlayer’s 
cache. 


client 
A software application that receives 
data from a server. A Web browser is a 
client of a Web server. RealPlayer is a 
client of RealServer. 

clip 
A media file within a presentation. 
Clips typically have an internal 
timeline, as with RealAudio and 
RealVideo. 
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codec 
Coder/decoder. Codecs convert data 
between uncompressed and 
compressed formats, reducing the 
bandwidth a clip consumes. 


download 
To send a file over a network with a 
nonstreaming protocol such as 
HTTP. Contrast to stream. 


encoding 
Converting a file into a compressed, 
streaming format. For example, you 
can encode WAV files as RealAudio. 


Flash 
1. A Macromedia tool for creating 


animations. 


2. A RealSystem clip type comprising 
Shockwave Flash and RealAudio. See 
also Shockwave Flash. 


HTTP 
The protocol used by Web servers to 
communicate with Web browsers. 
RealServer can use HTTP, but it 
streams clips to RealPlayer with 
RTSP. See also CHTTP. 


interstitial ad 
An ad that interrupts playback of a 
requested clip. It is like a commercial 
break on television. 

ISP 
Internet Service Provider. A company 
that provides access to the Internet. 


Many ISPs have RealServer available 
to stream media clips. 


Kilobit 
A common unit of data measurement 
equal to 1024 bits. A Kilobit is usually 
referred to in the context of bit rate 
per unit of time, such as Kilobits per 
second (Kbps). 

Kilobyte 
Acommon unit of data measurement 
equal to 1024 bytes. Also equal to 8 
Kilobits. 


PNA 
A proprietary protocol RealServer 
supports for backwards compatibility 
with RealSystem 3.0 through 5.0. 
URLs using PNA start with pnm://. 


port 
A connection to a server designated 
by a number such as 8080. RealServer 
uses different ports for the RTSP, 
HTTP, and PNA protocols. 


preroll 
Buffering that occurs at the start of a 
presentation. Preroll should be 15 
seconds or less. 

presentation 
A group of clips coordinated through 
SMIL and streamed from RealServer 
to RealPlayer. 


RDP 
The proprietary data package 
protocol RealServer uses (along with 
RTSP) when communicating with 
RealPlayer. Contrast to RTP. 
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RealAudio 
A RealSystem clip type for streaming 
audio over a network. RealAudio clips 


use the .rm or .ra extension. 


RealPix 
A RealSystem clip type (file extension 
.rp) for streaming still images over a 
network. It uses a mark-up language 
for creating special effects such as 


fades and zooms. 


RealPlayer 
RealNetworks client designed to play 
multimedia presentations streamed 
by RealServer or a Web server. 


RealServer 
RealNetworks server software used to 


stream multimedia presentations to 
RealPlayer. 


RealSystem 
The system for streaming clips such 
as RealAudio and RealVideo over a 
network. It consists of RealServer, 
RealPlayer, and production tools. 


RealText 
A RealSystem clip type (file extension 
.rt) for streaming text over a network. 
It uses a mark-up language for 
formatting text. 

real-time 
Delivered as it occurs. For example, a 
live broadcast is streamed across a 
network in real-time. 

RealVideo 
A RealSystem clip type for streaming 
video over a network. RealVideo clips 


use the .rm extension. 


rotating banner ads 
Banner advertisements that change at 
a specified interval, such as a new ad 
banner every 30 seconds. 


RTP 
The open, standards-based data 
package protocol RealServer uses 
(along with RTSP) to communicate 
with RTP-based clients. Contrast to 
RDP. 


RTSP 
The open, standards-based control 
protocol RealServer uses to stream 
clips to RealPlayer or any RTP-based 
client. Contrast to HTTP. 


server 
1. A software application, such as a 
Web server or RealServer, that sends 
clips over a network. 
2. A computer that runs server 


software. 


Shockwave Flash 
A compressed Flash file format (file 


extension .swf) used as the animation 


component in Flash. 


SMIL 
Synchronized Multimedia 
Integration Language. A mark-up 
language for specifying how and 
when each clip plays. SMIL files use 
the extension .smil or .smi. 

stream 
v. To send a media clip over a network 
so that it begins playing back as 
quickly as possible. 
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n. A flow of a single type of data, 
measured in Kilobits per second 
(Kbps). A RealVideo clip’s soundtrack 


is one stream, for example. 


SureStream 
A technology that allows switching to 
a lower-bandwidth encoding in a 
RealAudio or RealVideo clip to 
compensate for network congestion. 


Available only in RealSystem. 


U URL 
Uniform Resource Locator. A 
location description that lets a Web 
browser or RealPlayer receive a clip 
stored on a Web server or RealServer. 
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A ActiveX control 
aspect ratio, 142 
automatic playback, 144 
background color, 142 
basics of using, 131 
centering clip, 142 
class ID, 131 
consoles, 139 
image window, 134 
laying out presentations, 145 
logo suppression, 143 
looping playback 
indefinitely, 144 
set number of times, 144 
object ID, 131 
parameter list, 148 
parameters 
AUTOSTART, 144 
BACKGROUNDCOLOR, 142 
CENTER, 142 
CONSOLE, 139 
CONTROLS, 133 
HEIGHT, 132 
LOOP, 144 
MAINTAINASPECT, 142 
NOJAVA, 133 
NOLABELS, 143 
NOLOGO, 143 
NUMLOOP, 144 
REGION, 145 
SHUFFLE, 144 
SRC, 131 
WIDTH, 132 
RealPlayer controls, 133 
multiple, 139 
shuffling playback, 144 
size parameters, 132 


percentages, 133 
source parameter, 131 
specifying in links, 158 
supported applications, 129 
title suppression, 143 
URL handling, 133 
using in Web page, 131 
VBScript extensions, 130 

Ad streaming 
ad formats, 149 
banner ads 

duration, 152 

for broadcasts, 152 

layout, 150 

overview, 150 

properties, 152 

sizes, 150 
media ads 

commercial breaks, 155 

interstitial ads, 155 

lead-in video ad, 153 

overview, 153 

playlist disabling, 154 

region layout, 154 
overview, 149 
<RealAdInserv> tag, 153 
SMIL files for 

automatic generation, 150 

manual creation, 149 

Advertising 
on RealGuide, 170 
see also Ad streaming 
AIFF 
converting to RealAudio, 48 
streaming, 53 
Animation, see Flash 
ASF streaming, 65 
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AU 
converting to RealAudio, 48 
streaming, 53 
Audio 
cables, 45 
DC offset, 47 
digitizing, 47 
dynamics compression, 48 
frequency equalization, 48 
input levels, 46 
normalization, 47 
recording tips, 45 
source media, 45 
streaming 
formats for, 16 
steps for, 43 
see also RealAudio 
Authoring Kit, 4 
AVI 
converting to RealVideo, 61 
streaming, 65 


B Backwards compatibility 
overview, 12 
RealPlayer clip support, 17 
single URLs for, 12 
through Ram file, 167 
through Ramgen, 161 
Bandwidth 

available for presentations, 33 
common connection speeds, 33 
dividing between clips, 34 
Flash, 68 
multimedia clips, 37 
negotiation, 39 
overview, 31 
RealMedia characteristics, 34 
single media clip, 36 
SMIL choice settings, 94 
SureStream clips 

in SMIL file, 199 

overview, 39 

RealAudio, 53 

RealVideo, 63 
targets, 33 


Banner ads, see Ad streaming 
Bit rate, see Bandwidth 
Broadcasting 
archiving, 175 
banner ad durations, 152 
broadcast quality, 175 
CPU requirements, 175 
introduction, 171 
live vs. prerecorded, 171 
preparation, 174 
RealGuide listings, 170 
RealText, 172 
RGB and YUV, 172 
SMIL files, 176 
stream synchronization, 177 
tools, 172 
trial run, 175 


Caching, see RealPlayer 
Captions for the hearing impaired, 204 
CHTTP, 126 
Codecs 
see Bandwidth 
see RealVideo 
see RealAudio 
Compression 
audio dynamics, 48 
overview, 19 
RealAudio, 48 
RealVideo, 61 
CPU guidelines, 169 


Doubling clip sizes, 167 
Downloading 
RealPlayer plug-ins, 28 
versus streaming, 25 


EMBED tag, see Netscape plug-in 
Embedded presentations 

see ActiveX control 

see Netscape plug-in 
Encoding tools 

broadcasting, 172 

overview, 19 
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RealAudio, 52 
RealVideo, 62 
Extension list, 219 


F File extension list, 219 
Flash 
audio 
export, 76 
import, 68 
bandwidth 
gauging from file size, 75 
targeting, 68 
benefits of, 67 
Flash 3.0 features, 68 
frame rate, 73 
interactive commands, 74 
minimizing 
CPU usage, 73 
file size, 72 
overview, 67 
production tips, 71 
Ram files, 77 
RealPlayer 5.0 support, 77 
Shockwave export, 75 
SMIL mark-up, 77 
spreadsheet, 76 
stream synchronization, 68 
symbols, 73 
tools, 67 
tuning, 76 
tweening, 74 
Web server delivery, 163 
Full-screen playback, 167 


G_ GIF, see Images 
Graphics, see Images 


H HTML, see Web page 

HTTP 
compared to RTSP, 25 
in presentation links, 157 
in SMIL file, 84 
in Web page links, 158 
see also Web server 

Hypertext, see Links 


Images 
bandwidth use, 118 
caching, 125 
GIF background color, 119 
links to Web pages, 119 
RealPlayer control, 119 
reliable transmission, 120 
supported formats, 16 
see also RealPix 


JPEG, see Images 


Language choices 
codes, 223 
setting, 94 
Laying out presentations 
with ActiveX control, 145 
with HTML, 145 
with Netscape plug-in, 145 
with SMIL 
in RealPlayer, 99 
in Web page, 145 
Links 
in image tags, 119 
quick reference, 192 
Ram file 
to local files, 166 
to RealServer, 166 
to Web server, 166 
SMIL file 
base target, 83 
to local files, 84 
to RealServer, 82 
to Web server, 84 
Web page 
to RealServer, 158 
to Web Server, 161 
Live broadcast, see Broadcasting 


Metafile, see Ramgen 
MIME types in Web server, 165 
MPEG 
converting to RealAudio, 49 
converting to RealVideo, 61 
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N 


Netscape plug-in 
aspect ratio, 142 
automatic playback, 144 
background color, 142 
basics of using, 130 
centering clip, 142 
consoles, 139 
image window, 134 
JavaScript extensions, 130 
laying out presentations, 145 
local file links, 132 
logo suppression, 143 
looping playback 
indefinitely, 144 
set number of times, 144 
nonembedded links, 130 
parameter list, 148 
parameters 
AUTOSTART, 144 
BACKGROUNDCOLOR, 142 
CENTER, 142 
CONSOLE, 139 
CONTROLS, 133 
HEIGHT, 132 
LOOP, 144 
MAINTAINASPECT, 142 
NOJAVA, 133 
NOLABELS, 143 
NOLOGO, 143 
NUMLOOP, 144 
REGION, 145 
SHUFFLE, 144 
SRC, 131 
WIDTH, 132 
RealPlayer controls, 133 
multiple, 139 
shuffling playback, 144 
size parameters, 132 
percentages, 133 
source parameter, 131 
specifying in links, 158 
supported browsers, 129 
title suppression, 143 
URL handling, 133 
using in Web page, 129 


OBJECT tag, see ActiveX control 


Password authentication, 27 
Pay-per-view, 27 
Plug-ins 
see Netscape plug-in 
see RealPlayer 
PNA, 11 
PNG, see Images 
Preroll 
masking, 195 
overview, 32 
Protocols 
CHTTP, 126 
PNA, 11 
RDP, 11 
RTP, 11 
RTSP, 25 
Publishing tools, see Encoding tools 


QuickTime 
converting to RealAudio, 49 
converting to RealVideo, 61 
streaming, 65 


.ram extension, 160 
Ram file 
clip size, 167 
comments, 169 
creating manually, 165 
definition, 26 
linking 
to local files, 166 
to RealServer, 166 
to Web server, 166 
replacing with Ramgen, 160 
see also Ramgen 
Ramgen 
options 
altplay, 161 
combining, 161 
embed, 160 
using, 160 
RDP, 11 
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Real Broadcast Network (RBN), 173 
RealAudio 
bandwidth characteristics, 34 
batch encoding, 53 
broadcasting, 171 
codecs 
broadcasting with, 174 
list of, 49 
lossy nature, 49 
using, 49 
encoding tips, 52 
exporting from Flash, 76 
input formats, 48 
sampling rates, 49 
SureStream 
backwards compatibility, 53 
broadcasting, 174 
codecs for, 49 
Web server playback, 163 
see also Audio 
RealFlash, see Flash 
RealGuide, 170 
Real Pix 
bandwidth characteristics, 35 
description, 16 
Web server delivery, 163 
RealPlayer 
caching 
cache directory, 125 
cache size, 127 
CHTTP protocol, 126 
control commands, 126 
expiration rules, 127 
overriding, 126 
requirements, 125 
user control, 127 
captions preference, 204 
clip compatibility, 17 
control through image links, 119 
doubling clip size, 167 
download logo, 27 
embedding in Web page 
see ActiveX control 
see Netscape plug-in 
Flash interactivity, 74 


full-screen playback, 167 
language choices 


codes, 223 
setting, 94 
playlists 


disabling for ads, 154 
managing through SMIL, 96 
plug-in download, 28 
pop-up windows 
examples, 123 
links for, 121 
SMIL source view, 195 
supporting different versions, 201 


RealServer 


broadcasting, 173 
placing files on, 158 


RealSystem 


animation, see Flash 
architecture, 9 
media formats 

audio, 16 

image, 16 

new, 17 

text, 17 

video, 16 
overview, 25 
presentation testing, 169 


RealText 


bandwidth characteristics, 35 
broadcasting, 172 

captions, 204 

description, 17 

pop-up window links, 121 
Web server delivery, 163 


RealVideo 


bandwidth characteristics, 34 
broadcasting, 171 
codecs 

choosing, 61 

list of, 62 

lossy nature, 61 
cropping, 65 
encoding tips, 62 
input formats, 61 
production, 61 
resizing, 65 
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Scalable Video Technology, 64 
SureStream 
broadcasting, 174 
codec, 62 
see also Video 
Regions, see SMIL regions 
Relative links 
in Ram file, 165 
in SMIL, 83 
with Netscape plug-in, 132 
Rich media ads, see Ad streaming 
.rpm extension, 160 
RTP interoperability, 11 
RTSP 
and PNA, 11 
compared to HTTP, 25 
in presentation links, 157 
in SMIL file, 82 
overview, 25 


S Shockwave Flash, see Flash 
SMIL 
ad streaming with, 149 
anchors, 111 
bandwidth choices, 94 
broadcasting 
multiclip presentations, 176 
synchronization, 177 
caching 
authoring example, 128 
requirements, 125 
captions 
RealPlayer preference for, 204 
region filler, 205 
resizing for captions off, 205 
with groups, 205 
case sensitivity, 80 
clip information, 96 
clip type indicators, 81 
closing tag, 80 
coded characters, 98 
comments in, 81 
features, 22 
file location syntax 
for local machine, 84 


for RealServer, 82 
for Web server, 84 
relative links, 83 
Flash presentations, 77 
general rules, 80 
header 
coded characters, 98 
defining, 80 
hyperlinks, see SMIL links 
image commands 
bandwidth, 118 
caching, 125 
GIF background, 119 
RealPlayer control, 119 
reliable transmission, 120 
language choices 
codes, 223 
setting, 94 
layout, see SMIL regions 
links 
anchors, 111 
clip 
to clip, 109 
to SMIL file, 113 
hot spots 
pop-up windows, 124 
same window, 110 
pop-up window, 124 
spatial coordinates, 111 
temporal coordinates, 113 
timeline offsets, 115 
to Web pages, 110 
see also SMIL, file location syntax 
multifile playback, 165 
normal play time format, 89 
parallel tag, 85 
end values, 86 
repeating, 87 
with sequence tag, 87 
pop-up windows, 121 
presentation information, 95 
quotation marks for values, 80 
RealPlayer control, 119 
RealPlayer version support, 201 
regions 
assigning to clips, 107 
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background, 100 
colors, 103 
defining, 100 
hiding, 197 
media fit attributes, 104 
overlapping, 105 
percentage values, 102 
root-layout, 100 
transparency, 103 
repeating clips, 87 
sequence tag, 85 
repeating, 87 
with parallel tag, 87 
.smi extension, 81 
.smil extension, 81 
source file viewing, 195 
source tags, 81 
repeating, 87 
SureStream clips, 199 
switch tag, 93 
timing elements, 88 
begin, 89 
clip begin and end, 90 
with Web server delivery, 164 
duration, 91 
fill values, 92 
tips on using, 195 
title, author, copyright, 95 
viewing SMIL source, 195 
Web server playback, 164 
z-index, 105 
SND conversion to RealAudio, 49 
Streaming 
versus downloading, 25 
Web server, 161 
see also RealSystem 
SureStream 
backwards compatibility, 53 
broadcasting, 174 
overview, 39 
RealAudio codecs, 49 
RealVideo codec, 62 
with SMIL, 199 


T Technical support, 4 


Testing presentations, 169 
Timecast, see RealGuide 
Timing a presentation 
timeline synchronization, 20 
with SMIL, 85 


URLs, see links 


Video 
formats for streaming, 16 
lighting, 58 
movement, 57 
recording tips, 57 
source formats, 57 
streaming 
formats for, 65 
steps for, 55 
S-video, 59 
see also RealVideo 
Vivo streaming, 65 


Wallclocks for broadcasts, 177 
WAV 
converting to RealAudio, 49 
streaming, 53 
Web page 
linking presentation to, 158 
playback in, 129 
Web server 
MIME type configuration, 165 
playback 
instructions, 161 
limitations, 163 
Webcasting, see Broadcasting 
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